Media

List media assets

Newest media assets for the authenticated user. Pass drop_session_id after create_media_drop to list files uploaded on /drop/<token>.

get/api/v1/media

Request

  • Base URL: https://www.poster.ly
  • URL: https://www.poster.ly/api/v1/media
  • Auth: HTTP bearer

Query parameters

limitinteger

Page size. Defaults to 10, or 20 when drop_session_id is set so a full drop fits one page.

offsetinteger

Files to skip; use next_offset from the previous page. offset + limit can be at most 1000.

drop_session_idstring uuid

Filter to files uploaded through one media drop session.

Response

Media assets listed

totalinteger required

Exact number of matching files across all pages.

limitinteger
offsetinteger
has_moreboolean

True when more items exist after this page. Keep paging until it is false.

next_offsetinteger nullable

The offset of the next page, or null on the last page.

Example response

{
  "media": [
    {
      "id": "2f9b6a51-6f0e-4b58-9a5b-64b3a3f2f9d1",
      "public_url": "https://assets.poster.ly/users/123/launch.mp4",
      "filename": "launch.mp4",
      "path": "users/123/launch.mp4",
      "mime": "video/mp4",
      "bytes": 15000000,
      "created_at": "2026-09-08T12:00:00.000Z",
      "drop_session_id": "8c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f"
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0,
  "has_more": false,
  "next_offset": null
}

Changes

No recorded changes to this operation across all 1 revision of this API.