TWtwilio
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/{id}

Request

  • Base URL
    https://conversations.twilio.com
  • URL
    https://conversations.twilio.com/v2/ControlPlane/Operations/{id}
  • Auth
    HTTP basic

Response

Operation status

operationIdstring required

Unique identifier for the long-running operation.

status'PENDING' | 'COMPLETED' | 'FAILED' required

Lifecycle status of a long-running 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
}

Changes

No recorded changes to this operation across all 8 revisions of this API.