Remove queued message

Changed on

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

Removes one message from the queue so it never runs. Removing a message that's no longer queued isn't an error.

A collaborator in the editor can send a queued message into the turn that's running. While that's happening the message can't be changed or removed.

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.

<Note>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.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

delete/api/apps/{app_id}/chat/queue/{item_id}

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/chat/queue/{item_id}
  • Auth: HTTP bearer

Path parameters

item_idstring required

ID of the queued message to remove. Get it from items[].id in Get message queue.

app_idstring required

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

Query parameters

branch_idstring

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

Response

The queue without the message.

is_pausedboolean required

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

Example response

{
  "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"
    }
  ]
}

Changes

    • breaking

      query request parameter branch_id list-of-types was narrowed by removing types null

    • info

      for the query request parameter branch_id, the type was generalized from no type to string

    • info

      added the new optional query request parameter branch_id