Tool reference/automation

AUTOMATION

get_automation_runs

Read a paginated history of one automation’s runs and each publication destination. No provider calls or new jobs are started.

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

Request contract

Input parameters

kindstringrequired
"video""carousel"
automation_idintegerrequired
pageinteger
per_pageinteger

Exact JSON schemas

These are the schemas exported by the Caroush MCP server.

Input schema · JSON
{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "video",
        "carousel"
      ]
    },
    "automation_id": {
      "type": "integer",
      "minimum": 1
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000
    },
    "per_page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "kind",
    "automation_id"
  ],
  "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