Media

List media

Cursor-based paginated media listing with optional type, search, state, folder, label, usage, and sort filters.

get/v1/workspaces/{workspaceId}/media

Request

  • Base URL: https://api.maevesocial.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.maevesocial.com/v1/workspaces/{workspaceId}/media
  • Auth: HTTP bearer

Path parameters

workspaceIdstring uuid required

Workspace UUID.

Query parameters

folderIdstring uuid
rootOnlyboolean

Only return media in the workspace root folder.

labelIdsstring[]

Comma-separated media label UUIDs.

isUnlabeledboolean

Only return media with no attached media labels.

type'image' | 'video' | 'gif'
searchstring
isFavoriteboolean
isUsedboolean
isUnusedboolean
state'active' | 'deleted' | 'all'

Media lifecycle state. Active excludes Bin items; deleted returns Bin items.

sortBy'createdAt' | 'filename' | 'fileSize'
order'asc' | 'desc'
limitinteger
cursorstring
source'client_upload'

Only media uploaded through a client upload link.

Response

Paginated media list

Example response

{
  "meta": {
    "limit": 50,
    "hasMore": true,
    "nextCursor": "next-cursor-token"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.