Content API
Content API
Upload and manage media assets programmatically with the Content API.
Upload Content
`` POST /v1/content/upload Content-Type: multipart/form-data ``
Form fields:
file— The media file (required)name— Display name (optional, defaults to filename)tags— Comma-separated tags (optional)folder_id— Target folder ID (optional)
Response: ``json { "success": true, "data": { "id": "asset_abc123", "name": "Summer Promotion", "type": "image", "format": "jpeg", "width": 1920, "height": 1080, "size": 524288, "url": "https://cdn.govista.app/assets/...", "created_at": "2025-01-15T10:30:00Z" } } ``
Upload from URL
`` POST /v1/content/upload-url ``
Request body: ``json { "url": "https://example.com/image.jpg", "name": "Imported Image" } ``
List Content
`` GET /v1/content ``
Query parameters:
page,limit— Paginationtype— Filter:image,videotag— Filter by tagfolder_id— Filter by foldersearch— Search by name
Use the upload-url endpoint to integrate with your CMS. When new content is published on your website, automatically push it to GoVista via API.
Get Content Detail
`` GET /v1/content/:id ``
Update Content Metadata
`` PATCH /v1/content/:id ``
Request body: ``json { "name": "Updated Name", "tags": ["new-tag"], "folder_id": "folder_xyz" } ``
Delete Content
`` DELETE /v1/content/:id ``
List Folders
`` GET /v1/content/folders ``
Create Folder
`` POST /v1/content/folders ``
Request body: ``json { "name": "Summer 2025", "parent_id": null } ``
Content upload is limited to 2 GB per file via the API. For very large files, consider splitting videos or compressing before upload. The upload endpoint supports chunked transfer encoding for large files.