v2

latestOpenAPI 3.0.1raw.githubusercontent.com2026-05-072126235.6 KB
ConversationsV2Conversation

Delete a Conversation (async)

Asynchronously delete a conversation and all associated data. Returns 202 Accepted with an Operation-Id for status tracking via GET /v2/ControlPlane/Operations/{operationId}.

delete/v2/Conversations/{Sid}

Headers

Idempotency-Keystring

Client-generated UUID key to ensure idempotent behavior. Submitting the same key returns the original response without creating a duplicate operation. Keys are scoped to account + region with a 24-hour TTL.

Response

Operation accepted for asynchronous processing

statusUrlstring uri required

URL to poll for operation status.

relatedobject nullable

Named resource identifiers associated with this operation. Keys depend on the operation type:

  • config-create, config-update, config-delete: configurationId
  • conversation-delete: conversationId

Example response

{
  "statusUrl": "https://conversations.twilio.com/v2/ControlPlane/Operations/proc_job_01h9d8r0vte3hz8tykdj329t7r",
  "related": {
    "configurationId": "cfg_configuration_01h9d8r0vte3hz8tykdj329t7r"
  }
}