Cancel a pending AI retry in a conversation
Build a request to copy
This page never sends a request. Fill in the fields, then copy the request and run it from your server.
curl -X POST 'https://api.whatsable.app/v1/conversations/string/ai/retry/cancel'
Cancels the reply the AI agent was going to retry after an error in this conversation, as the inbox's cancel does. Calling it with no retry pending is safe and answers cancelled: false.
bearerAuthAuthorizationBearer <nfy_live_<32 characters>>An API key from Settings > API keys, sent as Authorization: Bearer <key>.
id*stringThe conversation id.
1 <= length <= 64Idempotency-Key?stringAny string up to 255 characters. A repeat with the same key and body answers the stored response; with another body, 409 idempotency_key_reused.
length <= 255Whether a retry was cancelled, and the conversation.
application/json- response
Whether a pending AI retry was cancelled, and the conversation as it now reads.
object*stringcancelled*booleanTrue when a reply the AI agent was going to retry after an error is now cancelled. False when no retry was pending, or it had already started.
conversation*One customer on one of the business numbers. One person writing to two numbers has two conversations.
curl -X POST 'https://api.whatsable.app/v1/conversations/string/ai/retry/cancel'{ "object": "ai_retry_cancellation", "cancelled": true, "conversation": { "object": "conversation", "id": "cm2v8c1a00001qz8h4t5u6v7w", "number_id": "cm2v8a1b20002qz8h9i0j1k2l", "contact_id": "cm2v8k1a00001qz8h8x9y0z1a", "contact_name": "Ana Pérez", "last_message_preview": "Is my order ready?", "last_message_at": "2026-10-20T19:51:21Z", "last_inbound_at": "2026-10-20T19:51:21Z", "last_outbound_at": "2026-10-20T18:00:00Z", "awaiting_reply": true, "window_expires_at": "2026-10-21T19:51:21Z", "window_open": true, "unread_count": 2, "marked_unread": false, "figures_to_check": 0, "ai": { "bot_id": "cm2v8b1a00001qz8h3j4k5l6m", "status": "active" }, "created_at": "2026-09-01T12:00:00Z", "updated_at": "2026-10-20T19:51:21Z" }}Switch the AI or choose its bot in a conversation PATCH
Switches the AI off or back on in one conversation, chooses which bot answers there, or both. `bot_id: null` falls back to the number's default bot. An `archived` bot cannot be chosen.
Switch the AI's follow-ups to a contact off or on PATCH
`off` stops the AI's follow-ups to this person on every number, and the bot keeps answering when they write. Sending `off` again is safe. `on` lets follow-ups start again from the next outbound message. It needs a key that may use every number the contact has a conversation on, or it answers `403 number_not_allowed_for_key`.