TWtwilio
ConversationsV2Action

Get Action Status

Changed on

Retrieve the current status of an Action.

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

Request

  • Base URL
    https://conversations.twilio.com
  • URL
    https://conversations.twilio.com/v2/Conversations/{ConversationId}/Actions/{ActionId}
  • Auth
    HTTP basic

Response

Action status.

idstring required

Unique identifier for this Action.

typestring required

The type of action: action-send-message or action-start-flow.

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

Lifecycle status of an Action.

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) For START_FLOW:
  • executionSid: The Studio Flow execution SID (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.

failureReasonstring nullable

Human-readable failure reason. Null unless status is FAILED.

Example response

{
  "id": "conv_action_00000000000000000000000000",
  "type": "action-send-message",
  "status": "COMPLETED",
  "conversationId": "conv_conversation_00000000000000000000000000",
  "related": {
    "messageSid": "SM1234567890abcdef1234567890abcdef",
    "communicationId": "conv_communication_00000000000000000000000000"
  },
  "createdAt": "2026-03-30T10:30:00Z",
  "completedAt": "2026-03-30T10:30:02Z"
}

Changes