API referenceMedia
List media assets
Returns the media library assets the API key can access (confirmed, excluding scene thumbnails).
RLS-scoped to the account; workspace-scoped keys see only their workspace. Cursor-paginated (created_at DESC, id DESC). Optional project_id filter.
Authorization
bearerAuth AuthorizationBearer <token>
Typecut API key. Generate one in app.typecut.ai → Settings → API keys. Send as Authorization: Bearer tc_live_….
In: header
Query Parameters
cursor?string
Opaque cursor from a previous response's next_cursor.
limit?integer
Max items per page.
Default
20Range
1 <= value <= 100project_id?string
Filter to one project.
Format
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/media"{
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
"workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
"public_url": "string",
"file_name": "string",
"content_type": "string",
"category": "string",
"width": 0,
"height": 0,
"duration": 0,
"thumbnail_url": "string",
"preview_url": "string",
"aspect_ratio": "string",
"source": "string",
"status": "string",
"created_at": "string"
}
],
"next_cursor": "string"
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}