complete_upload

Finish an upload

Verify uploaded bytes against their declared size, type and checksum, and return the upload ready to bind to a generation.

Scope

generation.write — Makes, edits, imports, shares and deletes media in the account.

Behaviour

Writes: Creates or changes items in the caller's own account.
Adds or updates: Adds or updates; nothing the caller already has is deleted or overwritten.
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.

Inputs

upload_idstring · required
uuid
checksum_sha256string · optional
matches ^[0-9a-f]{64}$
widthinteger · optional
> 0
heightinteger · optional
> 0

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

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "upload_id": {
      "type": "string",
      "format": "uuid"
    },
    "checksum_sha256": {
      "type": "string",
      "pattern": "^[0-9a-f]{64}$"
    },
    "width": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "height": {
      "type": "integer",
      "exclusiveMinimum": 0
    }
  },
  "required": [
    "upload_id"
  ],
  "additionalProperties": false
}

Related tools

create_upload
Reserve an upload and get a presigned URL to PUT the bytes to.

Every tool· This page as Markdown