---
title: "List ready creator media"
method: GET
path: "/v1/partners/{partnerId}/creators/{externalCreatorId}/media"
tags: ["Creator publishing"]
---

# List ready creator media

`GET /v1/partners/{partnerId}/creators/{externalCreatorId}/media`

## Request

- Base URL: `https://comet-api.example.invalid`
- URL: `https://comet-api.example.invalid/v1/partners/{partnerId}/creators/{externalCreatorId}/media`
- Auth: API key in header `x-api-key`

Requires page:read and configured media. Only ready assets in the current verified binding are returned, newest ready timestamp first with descending ID as tiebreaker. Does not browse legacy organization-wide media.

## Path parameters

- `partnerId` string, required
- `externalCreatorId` string, required

## Query parameters

- `cursor` string: Opaque ready-time/upload-ID cursor. Use the exact nextCursor; server also validates its timestamp.
- `limit` integer

## Headers

- `x-grant-generation` string, required

## Response `200`

Successful operation.

- MediaList
  - `schemaVersion` 1, required
  - `items` MediaAsset[], required
    - `id` string, required
    - `publicId` string, required
    - `url` string, uri, required
    - `thumbnailUrl` string, uri, required
    - `fileName` string, required: Nonblank filename, at most 180 Unicode code points; no path separators or control characters.
    - `mimeType` 'image/jpeg' | 'image/png' | 'image/webp' | 'video/mp4' | 'video/webm', required
    - `width` integer, required
    - `height` integer, required
    - `bytes` integer, required
    - `createdAt` string, date-time, required
  - `nextCursor` string, nullable, required: Opaque ready-time/upload-ID cursor. Use the exact nextCursor; server also validates its timestamp.

## Other responses

- `400`: INVALID_INPUT or UNSUPPORTED_SECTION.
- `401`: UNAUTHENTICATED: missing or invalid app credential, or unsupported Authorization header.
- `403`: Current grant, creator or realm authority does not allow this operation.
- `404`: Scoped resource is absent or unavailable.
- `409`: VERSION_CONFLICT, PREVIEW_CONFLICT, IDEMPOTENCY_CONFLICT, BINDING_CONFLICT or UPLOAD_IN_PROGRESS (retry the same media command after its active lease).
- `413`: Request exceeds the route limit: 256 KiB normally, 28 MiB JSON for POST media; decoded media limit is 5 MiB for images and 20 MiB for videos. Ingress parser failures may use a different envelope.
- `422`: CONTENT_NOT_READY: visible content is not ready for publication.
- `503`: FEATURE_DISABLED, AUTHORITY_UNAVAILABLE or MEDIA_UNAVAILABLE (unconfigured media or provider failure).

---

[API](https://skmtc.dev/comet/apis/comet-creator-publishing-api.md) - [All operations](https://skmtc.dev/comet/apis/comet-creator-publishing-api/llms.txt) - [OpenAPI document](https://skmtc.dev/comet/apis/comet-creator-publishing-api/revisions/04f959b645f0?raw)