Skip to main content
POST
/
media
Index videos in a collection
curl --request POST \
  --url https://api.trytldw.ai/v1/media/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "collection_id": "<string>",
  "media_list": [
    {
      "url": "<string>",
      "external_id": "video_12345",
      "title": "My Video",
      "metadata": {
        "location": {
          "lat": 1,
          "lon": 2
        },
        "owner_id": "user_123"
      }
    }
  ]
}
'
{
  "media_list": [
    {
      "id": "<string>",
      "external_id": "video_12345",
      "status": "PENDING"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
collection_id
string
required

The ID of the collection to add the video to

Example:

"c1a2b3c4-1a2b-3c4d-5e6f-7g8h9i0j1k2l"

​
media_list
NewMediaItem · object[]
required

List of videos to add. Maximum 10 media can be added per request

Examples:
{
  "external_id": "video_1",
  "title": "My Video1",
  "url": "https//example.com/video1.mp4"
}
{
  "external_id": "video_2",
  "title": "My Video2",
  "url": "https//example.com/video2.mp4"
}

Response

Successful Response

​
media_list
MediaStub · object[]
required