preview_queue_enqueue

Preview queue enqueue

Preview the exact queue enqueue mutation without committing it.

Authorization and permissions

Requires a valid delegated OAuth token and access to the selected workspace.

OAuth scope: mcp:read
Workspace requirement: Authorized workspace and current membership required

Operation-specific admin or publishing checks run during preview.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "accountId": {
      "description": "Account id.",
      "minimum": 1,
      "type": "integer"
    },
    "postId": {
      "description": "Public post sqid.",
      "maxLength": 32,
      "minLength": 1,
      "type": "string"
    },
    "startsAt": {
      "description": "Startsat.",
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "team_id": {
      "description": "Consented workspace ID.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "team_id",
    "postId",
    "accountId"
  ],
  "type": "object"
}

Result schema

{
  "additionalProperties": false,
  "properties": {
    "action": {
      "additionalProperties": false,
      "description": "Action.",
      "properties": {
        "accountId": {
          "description": "Account id.",
          "minimum": 1,
          "type": "integer"
        },
        "kind": {
          "const": "enqueue",
          "description": "Kind."
        },
        "postId": {
          "description": "Public post sqid.",
          "maxLength": 32,
          "minLength": 1,
          "type": "string"
        },
        "startsAt": {
          "description": "Startsat.",
          "format": "date-time",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "kind",
        "postId",
        "accountId"
      ],
      "type": "object"
    },
    "changes": {
      "description": "Changes.",
      "items": {
        "additionalProperties": false,
        "description": "Changes item.",
        "properties": {
          "account": {
            "description": "Account.",
            "type": "string"
          },
          "after": {
            "description": "After.",
            "type": [
              "string",
              "null"
            ]
          },
          "before": {
            "description": "Before.",
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "description": "Description.",
            "type": "string"
          },
          "postId": {
            "description": "Post id.",
            "type": "string"
          },
          "queued": {
            "description": "Queued.",
            "type": "boolean"
          }
        },
        "required": [
          "postId",
          "account",
          "description",
          "before",
          "after",
          "queued"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "token": {
      "description": "Token.",
      "type": "string"
    }
  },
  "required": [
    "token",
    "changes",
    "action"
  ],
  "type": "object"
}

Example arguments

{
  "accountId": 271,
  "postId": "P7k2Lm9Q",
  "startsAt": null,
  "team_id": 42
}

Example result

{
  "action": {
    "accountId": 271,
    "kind": "enqueue",
    "postId": "P7k2Lm9Q",
    "startsAt": null
  },
  "changes": [],
  "token": "opaque-token-from-preview"
}

Errors and retry

The connection is limited to 120 tool calls per user per minute and AI tools to 30 calls per user per hour. Invalid or cross-workspace identifiers return not found; revoked membership/scope returns permission denied; invalid input and stale versions return validation errors. Existing product limits still apply; there is no separate MCP subscription quota.

Preview is read-only and may be retried. It rolls back all writes; reuse the actual returned token only with the matching apply call within 15 minutes. Preview rechecks administrator or account publishing permission.

Effects, limits, and source

Workspace roles, subscription and AI usage limits, approval rules, and server rate limits are enforced at call time. Rate-limit responses identify when to retry; scheduled work returns state rather than holding the request open.

social_scheduling.services.team_queue.queue_command