> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Show end users their place in the queue or their wait time during a custom handoff

Custom handoff integrations built on the Handoffs API can now report the end user's position in the agent queue or their estimated wait. The new `PATCH /v2/conversations/{conversation_id}/handoff-queue/` endpoint takes a `unit` of `position`, `time`, or `unknown` and an `amount`. For `time`, the `amount` is the wait in seconds. Each update replaces the previous one.

On the Chat channel, the widget shows a "Waiting for an agent" banner with the reported position or the wait in whole minutes, or a generic waiting message for the `unknown` unit. The banner stays visible across a page reload. It clears when a human agent joins or the handoff ends. The endpoint accepts conversations on the Chat channel only, and only while a Handoffs API handoff is active and no human agent has joined yet. For request details and an example, see [Report the end user's place in the queue](/reference/conversations/developer-guides/creating-a-custom-handoff#optional-report-the-end-users-place-in-the-queue).