Tool reference/scheduling

SCHEDULING

list_schedules

List this user’s delivery records in the authorized workspace, filtered by platform, status, post, account or scheduled date. Reads saved records only.

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

Request contract

Input parameters

pageinteger
per_pageinteger
statusstring
"scheduled""publishing""automation_pending""awaiting_review""published""failed""cancelled"
providerstring
"instagram""tiktok""facebook""linkedin""twitter""threads""bluesky"
post_idinteger
social_account_idinteger
fromstring
untilstring

Exact JSON schemas

These are the schemas exported by the Caroush MCP server.

Input schema · JSON
{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000
    },
    "per_page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "status": {
      "type": "string",
      "enum": [
        "scheduled",
        "publishing",
        "automation_pending",
        "awaiting_review",
        "published",
        "failed",
        "cancelled"
      ]
    },
    "provider": {
      "type": "string",
      "enum": [
        "instagram",
        "tiktok",
        "facebook",
        "linkedin",
        "twitter",
        "threads",
        "bluesky"
      ]
    },
    "post_id": {
      "type": "integer",
      "minimum": 1
    },
    "social_account_id": {
      "type": "integer",
      "minimum": 1
    },
    "from": {
      "type": "string",
      "format": "date-time"
    },
    "until": {
      "type": "string",
      "format": "date-time"
    }
  },
  "required": [],
  "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