list_share_links

List share links

The live share links on one generation or upload — ids, ages, view counts and the settings the owner chose. With share_id: also that link's insights (views over time, where readers came from, reactions). URLs are never listed: only a link's hash is stored, so a lost URL is revoked and re-minted, not recovered. A group's links are not listable here.

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

referenceobject (type: "upload") or object (type: "generation") · required
share_idstring · optional
uuid

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_share_links",
    "arguments": {
      "reference": {
        "type": "upload",
        "upload_id": "00000000-0000-4000-8000-000000000000"
      }
    }
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "reference": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "upload"
            },
            "upload_id": {
              "type": "string",
              "format": "uuid"
            }
          },
          "required": [
            "type",
            "upload_id"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "generation"
            },
            "generation_id": {
              "type": "string",
              "format": "uuid"
            }
          },
          "required": [
            "type",
            "generation_id"
          ],
          "additionalProperties": false
        }
      ]
    },
    "share_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "reference"
  ],
  "additionalProperties": false
}

Related tools

list_generations
Search and page through the user's image, clip and audio generations.
get_generation
Get current status and signed media URL for one generation.
list_models
Read the full capability envelope for the models a room can run: aspect ratios, durations, resolutions, reference capacities, which inputs a model require…
get_credits
Use only the account's existing entitlements: when work is unavailable, explain the limit without offering purchases, upgrades, subscriptions or checkout…
get_usage
Read what the account spent and made in a week or month: credits, images, seconds of video and audio, and credits per model, with the comparable period be…
send_feedback
Tell Kuro's team when no tool can do what the user asked (missing_tool), a tool failed in a way its error did not explain (bug), a tool's behaviour was un…
get_account_context
Read what Kuro knows about the user before making anything: their name and language, what they optimize for when a model is picked (image_priority and cli…
get_benchmark
Which model to use for a job, in three tiers (best, middle, cheapest), priced for this account: credits per reference request, who pays (`paid_by`: one of…

Every tool· This page as Markdown