Tool

List ready media

List uploaded media ready to publish. Pass next_cursor as cursor to read the next page. Media must be uploaded in Cuekoo Studio first. If the list is empty, ask the user to upload the video or photos at /publish.

POSTtools.readFree

POST/openapi/v1/tools/list_media

Call it

curl -X POST https://api.cuekoo.com/openapi/v1/tools/list_media \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

The MCP tool is named cuekoo_list_media. Arguments and results are identical to the REST call.

Arguments

Send a JSON object with these fields. Scope: tools.read.

Name	Type	Required
`cursor`	`string`	Optional
`kind`	`string`	Optional
`limit`	`integer`	Optional

Response

Name	Type	Required
`items`	`object[] \| null`	Required
`items[].created_at`	`string`	Required
`items[].duration_seconds`	`number \| null`	Required
`items[].height`	`integer \| null`	Required
`items[].kind`	`string`	Required
`items[].media_id`	`string`	Required
`items[].mime`	`string`	Required
`items[].size_bytes`	`integer`	Required
`items[].width`	`integer \| null`	Required
`next_cursor`	`string`	Required

A call returns the Tool's output object at HTTP 200. Failures use the error envelope.

Credits

This Tool is free. It does not reserve or spend credits.