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

Changes the order queued messages run in. Pass the IDs in the new order.

A message that joined the queue after you read it, and so isn't in your list, keeps its place after the ones you list.

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>

{
  "item_ids": [
    "3b9d2f6e-8c41-4a7e-9f05-1d2c3b4a5e6f",
    "9a1c4e2b-6d3f-4b8a-a7e1-2f5c8d0b3e4a"
  ]
}

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