Pause message queue

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Pauses the queue. Queued messages wait until you call Resume message queue, and the turn that’s already running carries on.

On an app that queues messages, the ones you send with Send chat message while the queue is paused join it instead of running. On other apps a send runs right away even while the queue is paused, so pausing doesn’t stop new turns there.

Base44 doesn’t lift a pause you set, but it expires 24 hours after you set it.

This is limited to 60 requests per minute per app for each workspace’s personal API keys, so every key in a workspace shares one allowance. Every endpoint that changes the queue shares it. Some workspaces have a different limit.

This endpoint accepts a personal API key belonging to a user with editor access to the app. A read-only key is refused, and workspace API keys are not accepted.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

POST /api/apps/{app_id}/chat/queue/pause

Pause message queue

cURL

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/chat/queue/pause \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "branch_id": "68f1a2b3c4d5e6f708192a3b",
      "content": "Add a contact form to the home page",
      "created_at": "2026-10-05T14:30:00.123456+00:00",
      "id": "3b9d2f6e-8c41-4a7e-9f05-1d2c3b4a5e6f"
    }
  ],
  "is_paused": false
}

Authorizations

Authorization · string · header · required

Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.

Path Parameters

app_id · string · required

ID of the app whose message queue this request acts on.

Query Parameters

branch_id · string

ID of the branch to work on, as returned by List branches. Omit it to work on the app's main branch.

Response

200

application/json

The paused queue.

The messages waiting to run, in the order they run.

items · QueuedMessage · object[] · required

The queued messages, next to run first. Holds at most 7.

Show child attributes

Example:

[
  {
    "branch_id": "68f1a2b3c4d5e6f708192a3b",
    "content": "Add a contact form to the home page",
    "created_at": "2026-10-05T14:30:00.123456+00:00",
    "id": "3b9d2f6e-8c41-4a7e-9f05-1d2c3b4a5e6f"
  }
]

is_paused · boolean · required

Whether the queue is paused. While it is, queued messages don't run.

Example:

false