list_uploads

List uploads

Page through the account's uploads alone, newest first — list_media mixes them with generations. archived: true lists the archived ones instead. Each row carries the reference the generate tools take.

Scope

media.read — Reads the account: media, uploads, boards, runs, Subjects, models and the balance.

Behaviour

Read-only: Reads the caller's own account and changes nothing.
Stays in the account: Stays inside the caller's private Kuro account: any media provider it calls acts on Kuro's account, and the result is visible to no one else.
Idempotent: Calling it again with the same arguments has no further effect.

Inputs

kindstring · optional
one of "image", "video", "audio"
qstring · optional
at most 200 characters
archivedboolean · optional
cursorstring · optional
at most 500 characters
limitinteger · optional
≥ 1 · ≤ 100

Example call

A tools/call request with the required arguments only, each a placeholder read off the schema. Replace them before sending.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_uploads",
    "arguments": {}
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "image",
        "video",
        "audio"
      ]
    },
    "q": {
      "type": "string",
      "maxLength": 200
    },
    "archived": {
      "type": "boolean"
    },
    "cursor": {
      "type": "string",
      "maxLength": 500
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

Related tools

list_media
List ready generations and verified uploads already in the user's account, newest first.

Every tool· This page as Markdown