v2

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

ConversationsV2Action

Get Action Status

Retrieve the current status of an Action.

get/v2/Conversations/{ConversationId}/Actions/{ActionId}

Response

Action status.

idstring required

Unique identifier for this Action.

typestring required

The type of action. Accepted values: SEND_MESSAGE.

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

Current status of the Action.

PENDING: Action accepted, awaiting downstream confirmation
COMPLETED: Downstream backend confirmed the action
FAILED: Downstream backend reported a failure

conversationIdstring required

The conversation this action belongs to.

relatedobject

Named identifiers from downstream. For SEND_MESSAGE:

messageSid: The downstream message SID (present when PENDING or COMPLETED)
communicationId: The Communication ID (present when COMPLETED)

createdAtstring date-time required

Timestamp when the action was created.

updatedAtstring date-time

Timestamp when the action was last updated.

completedAtstring date-time

Timestamp when the action reached a terminal status.

Example response

{
  "id": "conv_action_01k1etx3jbfx88476ccja0889e",
  "type": "SEND_MESSAGE",
  "status": "COMPLETED",
  "conversationId": "conv_conversation_01k1etx3jbfx88476ccja0889c",
  "related": {
    "messageSid": "SM1234567890abcdef1234567890abcdef",
    "communicationId": "conv_communication_01k1etx3jbfx88476ccja0889c"
  },
  "createdAt": "2026-03-30T10:30:00Z",
  "completedAt": "2026-03-30T10:30:02Z"
}