Twilio Conversations API

The Conversations API from Twilio — 10 operation(s) for conversations.

Documentation

Specifications

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/twilio-conversations-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

twilio-conversations-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Twilio - Accounts A2p Conversations API
  description: This is the public Twilio REST API.
  termsOfService: https://www.twilio.com/legal/tos
  contact:
    name: Twilio Support
    url: https://support.twilio.com
    email: support@twilio.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  version: 1.52.0
servers:
- url: https://accounts.twilio.com
tags:
- name: Conversations
paths:
  /v1/Conversations:
    servers:
    - url: https://conversations.twilio.com
    description: A Conversation resource represents an omnichannel group conversation with an ordered list of messages and a participant roster.
    x-twilio:
      defaultOutputProperties:
      - sid
      - chat_service_sid
      - friendly_name
      - date_created
      pathType: list
      dependentProperties:
        participants:
          mapping:
            conversation_sid: sid
          resource_url: /v1/Conversations/{conversation_sid}/Participants
        messages:
          mapping:
            conversation_sid: sid
          resource_url: /v1/Conversations/{conversation_sid}/Messages
        webhooks:
          mapping:
            conversation_sid: sid
          resource_url: /v1/Conversations/{conversation_sid}/Webhooks
    post:
      description: Create a new conversation in your account's default service
      tags:
      - Conversations
      parameters:
      - name: X-Twilio-Webhook-Enabled
        in: header
        description: The X-Twilio-Webhook-Enabled HTTP request header
        schema:
          type: string
          $ref: '#/components/schemas/conversation_enum_webhook_enabled_type'
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/conversations.v1.conversation'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateConversation
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreateConversationRequest'
    get:
      description: Retrieve a list of conversations in your account's default service
      tags:
      - Conversations
      parameters:
      - name: StartDate
        in: query
        description: Start date or time in ISO8601 format for filtering list of Conversations. If a date is provided, the start time of the date is used (YYYY-MM-DDT00:00:00Z). Can be combined with other filters.
        schema:
          type: string
      - name: EndDate
        in: query
        description: End date or time in ISO8601 format for filtering list of Conversations. If a date is provided, the end time of the date is used (YYYY-MM-DDT23:59:59Z). Can be combined with other filters.
        schema:
          type: string
      - name: State
        in: query
        description: State for sorting and filtering list of Conversations. Can be `active`, `inactive` or `closed`
        schema:
          type: string
          $ref: '#/components/schemas/conversation_enum_state'
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListConversationResponse'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListConversation
      x-maturity:
      - GA
  /v1/Conversations/{Sid}:
    servers:
    - url: https://conversations.twilio.com
    description: A Conversation resource represents an omnichannel group conversation with an ordered list of messages and a participant roster.
    x-twilio:
      defaultOutputProperties:
      - sid
      - chat_service_sid
      - friendly_name
      - date_created
      pathType: instance
      dependentProperties:
        participants:
          mapping:
            conversation_sid: sid
          resource_url: /v1/Conversations/{conversation_sid}/Participants
        messages:
          mapping:
            conversation_sid: sid
          resource_url: /v1/Conversations/{conversation_sid}/Messages
        webhooks:
          mapping:
            conversation_sid: sid
          resource_url: /v1/Conversations/{conversation_sid}/Webhooks
    post:
      description: Update an existing conversation in your account's default service
      tags:
      - Conversations
      parameters:
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource. Can also be the `unique_name` of the Conversation.
        schema:
          type: string
        required: true
      - name: X-Twilio-Webhook-Enabled
        in: header
        description: The X-Twilio-Webhook-Enabled HTTP request header
        schema:
          type: string
          $ref: '#/components/schemas/conversation_enum_webhook_enabled_type'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/conversations.v1.conversation'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: UpdateConversation
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/UpdateConversationRequest'
    delete:
      description: Remove a conversation from your account's default service
      tags:
      - Conversations
      parameters:
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource. Can also be the `unique_name` of the Conversation.
        schema:
          type: string
        required: true
      - name: X-Twilio-Webhook-Enabled
        in: header
        description: The X-Twilio-Webhook-Enabled HTTP request header
        schema:
          type: string
          $ref: '#/components/schemas/conversation_enum_webhook_enabled_type'
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteConversation
      x-maturity:
      - GA
    get:
      description: Fetch a conversation from your account's default service
      tags:
      - Conversations
      parameters:
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource. Can also be the `unique_name` of the Conversation.
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/conversations.v1.conversation'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchConversation
      x-maturity:
      - GA
  /v1/Conversations/{ConversationSid}/Messages:
    servers:
    - url: https://conversations.twilio.com
    description: A Message resource represents a message in a conversation.
    x-twilio:
      defaultOutputProperties:
      - sid
      - index
      - author
      - date_created
      pathType: list
      dependentProperties:
        delivery_receipts:
          mapping:
            conversation_sid: conversation_sid
            message_sid: sid
          resource_url: /v1/Conversations/{conversation_sid}/Messages/{message_sid}/Receipts
        channel_metadata:
          mapping:
            conversation_sid: conversation_sid
            message_sid: sid
          resource_url: /v1None
      parent: /Conversations/{Sid}
    post:
      description: Add a new message to the conversation
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this message.
        schema:
          type: string
        required: true
      - name: X-Twilio-Webhook-Enabled
        in: header
        description: The X-Twilio-Webhook-Enabled HTTP request header
        schema:
          type: string
          $ref: '#/components/schemas/conversation_message_enum_webhook_enabled_type'
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/conversations.v1.conversation.conversation_message'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateConversationMessage
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreateConversationMessageRequest'
    get:
      description: Retrieve a list of all messages in the conversation
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for messages.
        schema:
          type: string
        required: true
      - name: Order
        in: query
        description: 'The sort order of the returned messages. Can be: `asc` (ascending) or `desc` (descending), with `asc` as the default.'
        schema:
          type: string
          $ref: '#/components/schemas/conversation_message_enum_order_type'
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListConversationMessageResponse'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListConversationMessage
      x-maturity:
      - GA
  /v1/Conversations/{ConversationSid}/Messages/{Sid}:
    servers:
    - url: https://conversations.twilio.com
    description: A Message resource represents a message in a conversation.
    x-twilio:
      defaultOutputProperties:
      - sid
      - index
      - author
      - date_created
      pathType: instance
      dependentProperties:
        delivery_receipts:
          mapping:
            conversation_sid: conversation_sid
            message_sid: sid
          resource_url: /v1/Conversations/{conversation_sid}/Messages/{message_sid}/Receipts
        channel_metadata:
          mapping:
            conversation_sid: conversation_sid
            message_sid: sid
          resource_url: /v1None
      parent: /Conversations/{Sid}
    post:
      description: Update an existing message in the conversation
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this message.
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^IM[0-9a-fA-F]{32}$
        required: true
      - name: X-Twilio-Webhook-Enabled
        in: header
        description: The X-Twilio-Webhook-Enabled HTTP request header
        schema:
          type: string
          $ref: '#/components/schemas/conversation_message_enum_webhook_enabled_type'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/conversations.v1.conversation.conversation_message'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: UpdateConversationMessage
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/UpdateConversationMessageRequest'
    delete:
      description: Remove a message from the conversation
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this message.
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^IM[0-9a-fA-F]{32}$
        required: true
      - name: X-Twilio-Webhook-Enabled
        in: header
        description: The X-Twilio-Webhook-Enabled HTTP request header
        schema:
          type: string
          $ref: '#/components/schemas/conversation_message_enum_webhook_enabled_type'
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteConversationMessage
      x-maturity:
      - GA
    get:
      description: Fetch a message from the conversation
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this message.
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^IM[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/conversations.v1.conversation.conversation_message'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchConversationMessage
      x-maturity:
      - GA
  /v1/Conversations/{ConversationSid}/Messages/{MessageSid}/Receipts/{Sid}:
    servers:
    - url: https://conversations.twilio.com
    description: A Message Receipt resource represents a delivery/read receipt of a message in a conversation.
    x-twilio:
      defaultOutputProperties:
      - sid
      - message_sid
      - status
      - date_created
      pathType: instance
      parent: /Conversations/{ConversationSid}/Messages/{Sid}
      mountName: delivery_receipts
    get:
      description: Fetch the delivery and read receipts of the conversation message
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this message.
        schema:
          type: string
        required: true
      - name: MessageSid
        in: path
        description: The SID of the message within a [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) the delivery receipt belongs to.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^IM[0-9a-fA-F]{32}$
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^DY[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/conversations.v1.conversation.conversation_message.conversation_message_receipt'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchConversationMessageReceipt
      x-maturity:
      - GA
  /v1/Conversations/{ConversationSid}/Messages/{MessageSid}/Receipts:
    servers:
    - url: https://conversations.twilio.com
    description: A Message Receipt resource represents a delivery/read receipt of a message in a conversation.
    x-twilio:
      defaultOutputProperties:
      - sid
      - message_sid
      - status
      - date_created
      pathType: list
      parent: /Conversations/{ConversationSid}/Messages/{Sid}
      mountName: delivery_receipts
    get:
      description: Retrieve a list of all delivery and read receipts of the conversation message
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this message.
        schema:
          type: string
        required: true
      - name: MessageSid
        in: path
        description: The SID of the message within a [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) the delivery receipt belongs to.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^IM[0-9a-fA-F]{32}$
        required: true
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListConversationMessageReceiptResponse'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListConversationMessageReceipt
      x-maturity:
      - GA
  /v1/Conversations/{ConversationSid}/Participants:
    servers:
    - url: https://conversations.twilio.com
    description: A Participant resource represents a member of the conversation.
    x-twilio:
      defaultOutputProperties:
      - sid
      - messaging_binding
      pathType: list
      parent: /Conversations/{Sid}
    post:
      description: Add a new participant to the conversation
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this participant.
        schema:
          type: string
        required: true
      - name: X-Twilio-Webhook-Enabled
        in: header
        description: The X-Twilio-Webhook-Enabled HTTP request header
        schema:
          type: string
          $ref: '#/components/schemas/conversation_participant_enum_webhook_enabled_type'
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/conversations.v1.conversation.conversation_participant'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateConversationParticipant
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreateConversationParticipantRequest'
    get:
      description: Retrieve a list of all participants of the conversation
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for participants.
        schema:
          type: string
        required: true
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListConversationParticipantResponse'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListConversationParticipant
      x-maturity:
      - GA
  /v1/Conversations/{ConversationSid}/Participants/{Sid}:
    servers:
    - url: https://conversations.twilio.com
    description: A Participant resource represents a member of the conversation.
    x-twilio:
      defaultOutputProperties:
      - sid
      - messaging_binding
      pathType: instance
      parent: /Conversations/{Sid}
    post:
      description: Update an existing participant in the conversation
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this participant.
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
        required: true
      - name: X-Twilio-Webhook-Enabled
        in: header
        description: The X-Twilio-Webhook-Enabled HTTP request header
        schema:
          type: string
          $ref: '#/components/schemas/conversation_participant_enum_webhook_enabled_type'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/conversations.v1.conversation.conversation_participant'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: UpdateConversationParticipant
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/UpdateConversationParticipantRequest'
    delete:
      description: Remove a participant from the conversation
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this participant.
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
        required: true
      - name: X-Twilio-Webhook-Enabled
        in: header
        description: The X-Twilio-Webhook-Enabled HTTP request header
        schema:
          type: string
          $ref: '#/components/schemas/conversation_participant_enum_webhook_enabled_type'
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteConversationParticipant
      x-maturity:
      - GA
    get:
      description: Fetch a participant of the conversation
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this participant.
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource. Alternatively, you can pass a Participant's `identity` rather than the SID.
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/conversations.v1.conversation.conversation_participant'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchConversationParticipant
      x-maturity:
      - GA
  /v1/Conversations/{ConversationSid}/Webhooks:
    servers:
    - url: https://conversations.twilio.com
    description: A Scoped Webhook resource manages a set of callback URLs and their configuration for receiving events specific to one conversation.
    x-twilio:
      defaultOutputProperties:
      - sid
      - target
      pathType: list
      parent: /Conversations/{Sid}
    get:
      description: Retrieve a list of all webhooks scoped to the conversation
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this webhook.
        schema:
          type: string
        required: true
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListConversationScopedWebhookResponse'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListConversationScopedWebhook
      x-maturity:
      - GA
    post:
      description: Create a new webhook scoped to the conversation
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this webhook.
        schema:
          type: string
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/conversations.v1.conversation.conversation_scoped_webhook'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateConversationScopedWebhook
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreateConversationScopedWebhookRequest'
  /v1/Conversations/{ConversationSid}/Webhooks/{Sid}:
    servers:
    - url: https://conversations.twilio.com
    description: A Scoped Webhook resource manages a set of callback URLs and their configuration for receiving events specific to one conversation.
    x-twilio:
      defaultOutputProperties:
      - sid
      - target
      pathType: instance
      parent: /Conversations/{Sid}
    get:
      description: Fetch the configuration of a conversation-scoped webhook
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this webhook.
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^WH[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/conversations.v1.conversation.conversation_scoped_webhook'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchConversationScopedWebhook
      x-maturity:
      - GA
    post:
      description: Update an existing conversation-scoped webhook
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this webhook.
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^WH[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/conversations.v1.conversation.conversation_scoped_webhook'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: UpdateConversationScopedWebhook
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/UpdateConversationScopedWebhookRequest'
    delete:
      description: Remove an existing webhook scoped to the conversation
      tags:
      - Conversations
      parameters:
      - name: ConversationSid
        in: path
        description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this webhook.
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^WH[0-9a-fA-F]{32}$
        required: true
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteConversationScopedWebhook
      x-maturity:
      - GA
components:
  schemas:
    conversations.v1.conversation.conversation_message:
      type: object
      properties:
        account_sid:
          type:
          - string
          - 'null'
          minLength: 34
          maxLength: 34
          pattern: ^AC[0-9a-fA-F]{32}$
          description: The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this message.
        conversation_sid:
          type:
          - string
          - 'null'
          minLength: 34
          maxLength: 34
          pattern: ^CH[0-9a-fA-F]{32}$
          description: The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this message.
        sid:
          type:
          - string
          - 'null'
          minLength: 34
          maxLength: 34
          pattern: ^IM[0-9a-fA-F]{32}$
          description: A 34 character

# --- truncated at 32 KB (65 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/openapi/twilio-conversations-api-openapi.yml