Nimply Developers
API ReferenceMedia

List media assets

GET
/v1/media

Cursor-paginated, newest first. Filter with ?type=.

AuthorizationBearer <token>

Workspace API key (nim_live_...)

In: header

Query Parameters

type?string

Filter by media type

Value in

  • "IMAGE"
  • "VIDEO"
  • "GIF"
  • "DOCUMENT"
limit?number

Page size (1–100, default 25)

Default25
cursor?string

Cursor from the previous page (nextCursor)

Response Body

application/json

curl -X GET "https://example.com/v1/media"
{  "data": [    {      "id": "123e4567-e89b-12d3-a456-426614174000",      "name": "launch-banner.png",      "type": "IMAGE",      "url": "string",      "thumbnailUrl": {},      "size": 245760,      "createdAt": "2026-07-05T10:00:00.000Z"    }  ],  "nextCursor": {}}