Sign in
ConversationsV1Conversation

Update an existing conversation in your account's default service

Update an existing conversation in your account's default service

post/v1/Conversations/{Sid}

Path parameters

Sidstring required

A 34 character string that uniquely identifies this resource. Can also be the unique_name of the Conversation.

Headers

X-Twilio-Webhook-Enabled'true' | 'false'

The X-Twilio-Webhook-Enabled HTTP request header

Response

OK

account_sidstring nullable

The unique ID of the Account responsible for this conversation.

chat_service_sidstring nullable

The unique ID of the Conversation Service this conversation belongs to.

messaging_service_sidstring nullable

The unique ID of the Messaging Service this conversation belongs to.

sidstring nullable

A 34 character string that uniquely identifies this resource.

friendly_namestring nullable

The human-readable name of this conversation, limited to 256 characters. Optional.

unique_namestring nullable

An application-defined string that uniquely identifies the resource. It can be used to address the resource in place of the resource's sid in the URL.

attributesstring nullable

An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. Note that if the attributes are not set "{}" will be returned.

state'initializing' | 'inactive' | 'active' | 'closed'

Current state of this conversation. Can be either initializing, active, inactive or closed and defaults to active

date_createdstring date-time nullable

The date that this resource was created.

date_updatedstring date-time nullable

The date that this resource was last updated.

{"stackTrail":"components:schemas:conversations.v1.conversation:properties:timers","oasType":"schema","type":"unknown","description":"Timer date values representing state update for this conversation.","nullable":true}
urlstring uri nullable

An absolute API resource URL for this conversation.

linksobject nullable

Contains absolute URLs to access the participants, messages and webhooks of this conversation.

{"stackTrail":"components:schemas:conversations.v1.conversation:properties:bindings","oasType":"schema","type":"unknown","nullable":true}

Changes

Changed in 5 of the 51 revisions of this API.414

  • v17c6893e0ba6811See the full diff
    • ●

      added the new initializing enum value to the state response property for the response status 200

      response-property-enum-value-added

    • ○

      added the new initializing enum value to the request property State

      request-property-enum-value-added

  • v192d1169c37c22See the full diff
    • ▲

      the bindings response's property type/format changed from object/ to / for status 200

      response-property-type-changed

    • ▲

      the timers response's property type/format changed from object/ to / for status 200

      response-property-type-changed

  • v1b4d0e634cd692See the full diff
    • ▲

      the bindings response's property type/format changed from / to object/ for status 200

      response-property-type-changed

    • ▲

      the timers response's property type/format changed from / to object/ for status 200

      response-property-type-changed

  • v1bf66b70e986b2See the full diff
    • ○

      added the new optional request property Bindings.Email.Address

      new-optional-request-property

    • ○

      added the new optional request property Bindings.Email.Name

      new-optional-request-property

  • v14e3f150aaa781See the full diff
    • ○

      api tag ConversationsV1Conversation added

      api-tag-added