Media

Upload media

Uploads one or more files and returns a dp:// reference per file for use in POST /jobs datapoints.

Request

Multipart form-data with one or more files fields:

Content-Type: multipart/form-data

--boundary
Content-Disposition: form-data; name="files"; filename="video_a.mp4"
Content-Type: video/mp4

<binary>
--boundary
Content-Disposition: form-data; name="files"; filename="video_b.mp4"
Content-Type: video/mp4

<binary>
--boundary--

Files in a batch are processed sequentially, and there is no partial rollback: if the third file in a batch fails, the first two are already stored and keep their references. The whole batch is handled within a single request, so keep batches modest rather than sending very large numbers of files at once.

Response (200 OK)

{
  "media": [
    {
      "filename": "video_a.mp4",
      "media_id": "b6a1cd3f-1234-4abc-9def-0123456789ab",
      "media_ref": "dp://b6a1cd3f1234/video_a.mp4",
      "type": "video",
      "size_bytes": 2457623,
      "url": "/media/v2/b6a1cd3f-1234-4abc-9def-0123456789ab?cid=...&exp=1753280000&sig=..."
    }
  ]
}

Supported formats

The media type is taken from the file extension. The request Content-Type is only a cross-check:

• Extension not in the table above → 400 (unsupported_media_extension). Upload one of the supported formats.
• Extension and Content-Type disagree (e.g. a .mp4 sent as image/png) → 400 (media_type_mismatch).
• A Content-Type the platform doesn't recognise is ignored — the extension still governs.

.svg uploads are sanitised on the way in (script vectors and unsafe references are stripped). An SVG that can't be parsed is rejected with 400 (invalid_svg).

Preview frames are generated for video only, and not at upload time — the poster frame is produced the first time the video is used in a job. The upload response's url always serves the full object; poster frames are served by thumbnail_url in GET /media.

Example

curl -X POST https://api.trydatapoint.com/data-labelling/v1/media \
  -H "X-API-Key: $DATAPOINT_KEY" \
  -F "files=@video_a.mp4" \
  -F "files=@video_b.mp4"

Error cases

List media

Lists your account's media — both files you uploaded through POST /media and media the platform fetched from direct URLs in your jobs — newest first. Paginated.

Query parameters

Response (200 OK)

{
  "media": [
    {
      "media_id": "b6a1cd3f-1234-4abc-9def-0123456789ab",
      "filename": "video_a.mp4",
      "media_ref": "dp://b6a1cd3f1234/video_a.mp4",
      "type": "video",
      "size_bytes": 2457623,
      "moderation_status": "allowed",
      "created_at": "2026-07-23T18:11:04Z",
      "url": "/media/v2/b6a1cd3f-1234-4abc-9def-0123456789ab?cid=...&exp=1753280000&sig=...",
      "thumbnail_url": "/media/v2/b6a1cd3f-1234-4abc-9def-0123456789ab?cid=...&exp=1753280000&sig=...&preview=1"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 50
}

Each item in media:

Next

• Media handling concepts: how dp:// refs are served end-to-end
• Task types: where to plug media refs into datapoints