Tool reference/carousels

CAROUSELS

regenerate_carousel

Queue a revision of an owned carousel. Targets slide/image require slide_index; other targets forbid it. New images cost 5 credits each; copy/hook/layout reuse images. Uploaded CTA artwork cannot be regenerated. Existing images remain available on failure.

Mutationmanage:carousels
Take the docs with youMarkdown for your editor or agent.
Download guide
TransportStreamable HTTP
Methodtools/call
ExecutionImmediate handler

Every new action requires a UUID idempotency_key. Reuse the same key and arguments for retries. Read the approval flow.

Request contract

Input parameters

run_idintegerrequired
targetstringrequired
"hook""slide""copy""visual""image""layout""all"
slide_indexinteger
idempotency_keystringrequired

A new UUID per intended action. Reuse exactly for retries; never reuse with different arguments.

Exact JSON schemas

These are the schemas exported by the Caroush MCP server.

Input schema · JSON
{
  "type": "object",
  "properties": {
    "run_id": {
      "type": "integer",
      "minimum": 1
    },
    "target": {
      "type": "string",
      "enum": [
        "hook",
        "slide",
        "copy",
        "visual",
        "image",
        "layout",
        "all"
      ]
    },
    "slide_index": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "idempotency_key": {
      "type": "string",
      "format": "uuid",
      "description": "A new UUID per intended action. Reuse exactly for retries; never reuse with different arguments."
    }
  },
  "required": [
    "run_id",
    "target",
    "idempotency_key"
  ],
  "additionalProperties": false
}

Read the actual outcome

A successful handler response does not necessarily mean generation or publication is finished. Follow the returned operation, native run or schedule status. Results and job states

Back to all 49 tools