For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportStatusTry now
DocumentationAPI Reference
DocumentationAPI Reference
    • API Overview
  • API Guides
    • Authentication
    • Concurrency & Rate Limits
    • Batch Processing
    • Webhooks
  • Generate API
    • POSTCreate Generation
    • POSTCreate Generation with Files
    • GETGet Generation
    • GETList Generations
    • POSTEstimate Cost
  • Batch API
    • POSTCreate Batch
    • GETGet Batch
    • GETList Batches
  • Assets API
    • GETList Assets
    • GETGet Asset
  • Models API
    • GETList Models
  • Webhooks Payload Reference
LogoLogo
SupportStatusTry now
Assets API

Get Asset

GET
/v2/assets/:id
GET
/v2/assets/:id
$curl https://api.sync.so/v2/assets/550e8400-e29b-41d4-a716-446655440000 \
>     -H "x-api-key: <apiKey>"
1{
2  "id": "550e8400-e29b-41d4-a716-446655440000",
3  "createdAt": "2024-01-15T09:30:00Z",
4  "updatedAt": "2024-01-15T09:30:00Z",
5  "type": "VIDEO",
6  "visibility": "ORGANIZATION",
7  "name": "example-video.mp4",
8  "url": "https://assets.sync.so/example-video.mp4",
9  "size": 10485760,
10  "format": "mp4",
11  "inputType": "UPLOAD",
12  "durationSeconds": 30.5,
13  "thumbnailUrl": "https://assets.sync.so/thumb-example.jpg",
14  "width": 1920,
15  "height": 1080
16}
Retrieve a specific asset by ID.
Was this page helpful?
Previous

List Models

Next
Built with

Authentication

x-api-keystring
API Key authentication via header

Path parameters

idstringRequired
A unique identifier for an asset.

Response

Asset retrieved successfully
idstring
A unique identifier for an asset.
createdAtdatetime
The date and time the asset was created.
updatedAtdatetime
The date and time the asset was last updated.
typeenum
The type of asset file.
Allowed values:
visibilityenum
Visibility scope for the asset.
Allowed values:
namestring
The filename of the asset.
urlstring
The URL to access the asset media.
sizelong
File size in bytes.
formatstring

File format/extension (e.g., “mp4”, “wav”).

inputTypeenum
The source type of the asset.
durationSecondsdouble

Duration of the media in seconds (for audio/video).

thumbnailUrlstring
URL to the asset's thumbnail image.
widthinteger

Width in pixels (for video/image).

heightinteger

Height in pixels (for video/image).

Errors

401
Unauthorized Error
404
Not Found Error
500
Internal Server Error