bymundi API

Complete a catalog photo upload

The complete_catalog_image_upload MCP tool: complete a catalog photo upload.

complete_catalog_image_upload · writes

REST: POST /v1/catalog/entities/{entityId}/images/{assetId}/complete

What the model reads

Completes an upload started with start_catalog_image_upload, once its bytes were PUT: bymundi re-encodes the photo and attaches it to the entry (last, or the lead photo with position: first). undo_change takes it off again.

Permissions: catalog:write. Undo: the result names a change id; undo_change reverts it.

Input

Field Type Required Description
entityId uuid yes
assetId uuid yes
alt string A description of the photo for screen readers (recommended). max 300 chars
position "first" | "last" first makes it the entry's lead photo; last (the default) appends it. default "last"

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "entityId": {
      "type": "string",
      "format": "uuid"
    },
    "assetId": {
      "type": "string",
      "format": "uuid"
    },
    "alt": {
      "type": "string",
      "maxLength": 300,
      "description": "A description of the photo for screen readers (recommended)."
    },
    "position": {
      "type": "string",
      "enum": [
        "first",
        "last"
      ],
      "default": "last",
      "description": "`first` makes it the entry's lead photo; `last` (the default) appends it."
    }
  },
  "required": [
    "entityId",
    "assetId"
  ],
  "additionalProperties": false
}