v2

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

ConversationsV2Operation

Get Operation Status

Retrieve the current status of a long-running operation. Operations progress through: PENDING -> RUNNING -> COMPLETED or FAILED.

get/v2/ControlPlane/Operations/{Sid}

Response

Operation status

operationIdstring required

Unique identifier for the long-running operation.

status'PENDING' | 'RUNNING' | 'CANCELLED' | 'COMPLETED' | 'FAILED' required

Current status of the operation.

createdAtstring date-time required

Timestamp when the operation was created.

completedAtstring date-time nullable

Timestamp when the operation completed. Only present for completed or failed operations.

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

{
  "operationId": "proc_job_01h9d8r0vte3hz8tykdj329t7r",
  "status": "COMPLETED",
  "createdAt": "2025-01-15T10:30:00Z",
  "completedAt": "2025-01-15T10:30:05Z",
  "statusUrl": "https://conversations.twilio.com/v2/ControlPlane/Operations/proc_job_01h9d8r0vte3hz8tykdj329t7r",
  "related": {
    "configurationId": "cfg_configuration_01h9d8r0vte3hz8tykdj329t7r"
  },
  "error": null
}