List Assets

import requests
url = "https://api.sync.so/v2/assets"
querystring = {"limit":"10","sortBy":"dateDesc"}
headers = {"x-api-key": "<apiKey>"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z",
      "type": "VIDEO",
      "visibility": "ORGANIZATION",
      "name": "example-video.mp4",
      "url": "https://assets.sync.so/example-video.mp4",
      "size": 10485760,
      "format": "mp4",
      "inputType": "UPLOAD",
      "durationSeconds": 30.5,
      "thumbnailUrl": "https://assets.sync.so/thumb-example.jpg",
      "width": 1920,
      "height": 1080
    }
  ],
  "nextCursor": "cursor_abc123",
  "totalCount": 42
}

List all assets in your organization's media library.

Authentication

x-api-keystring

API Key authentication via header

Query parameters

projectIdstringOptional

Filter assets by project ID.

limitintegerOptional

Maximum number of assets to return (1-100).

cursorstringOptional

Cursor for pagination.

searchQuerystringOptional

Search assets by name.

sortByenumOptional

Sort order for the results.

typeslist of enumsOptional

Filter by asset types. Accepts multiple types as a comma-separated list (AUDIO, VIDEO, IMAGE).

Allowed values:

Response

Assets retrieved successfully

itemslist of objects

Array of assets.

nextCursorstring or null

Cursor for fetching the next page of results.

totalCountinteger or null

Total number of assets matching the query.

Authentication

Query parameters

Response

Errors