cancel_post

Access and behavior

Write or Administrator OAuth consent and a member/administrator team role are required. Tools are listed and callable only when the current grant and role permit them.

Cancellation stops pending deliveries. It does not remove provider-side publications, and a group with work already preparing or publishing cannot be cancelled safely.

Confirm the exact target and consequence with the user before calling this tool.

Arguments

Argument	Required	Type or meaning
`postId`	Yes	Posting-group UUID returned by list_posts or create_post.

Complete input schema

{
  "type": "object",
  "properties": {
    "postId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": ["postId"],
  "additionalProperties": false
}

Example result

Posted returns this object in structuredContent and a JSON text content block. A tool failure sets isError; never treat an error as a completed mutation.

{
  "post": {
    "id": "22222222-2222-4222-8222-222222222222",
    "text": "A small update from the studio.",
    "additionalPosts": [],
    "mediaOverrides": {},
    "scheduledAt": "2027-01-18T09:30:00.000Z",
    "idempotencyKey": "studio-update-2027-01-18",
    "state": "cancelled",
    "version": 1,
    "createdAt": "2027-01-18T09:30:00.000Z",
    "media": [
      {
        "id": "44444444-4444-4444-8444-444444444444",
        "fileName": "studio.jpg",
        "contentType": "image/jpeg",
        "sizeBytes": 245760,
        "width": 1600,
        "height": 900,
        "alt": "A bright studio desk beside a window",
        "durationSeconds": null
      }
    ],
    "managedBy": {
      "id": "66666666-6666-4666-8666-666666666666",
      "name": "Alex Morgan",
      "avatarUrl": null
    },
    "deliveries": [
      {
        "id": "77777777-7777-4777-8777-777777777777",
        "postIndex": 0,
        "connectionId": "11111111-1111-4111-8111-111111111111",
        "provider": "bluesky",
        "accountName": "Alex Morgan",
        "textOverride": null,
        "state": "cancelled",
        "providerPostId": null,
        "publishedUrl": null,
        "error": null,
        "publishedAt": null
      }
    ]
  }
}

Connect a client

MCP reference

API Reference

Workflow

Access and behavior

Arguments

Example call

Example result

​Workflow

​Access and behavior

​Arguments

​Example call

​Example result

​Related reference

Workflow

Access and behavior

Arguments

Example call

Example result

Related reference