@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Twilio - Conversations
@base https://conversations.twilio.com
@version 1.0.0
@auth Bearer basic
@endpoints 103
@hint download_for_search
@toc Configuration(9), Conversations(22), ConversationWithParticipants(1), Credentials(5), ParticipantConversations(1), Roles(5), Services(51), Users(9)

@group Configuration
@endpoint GET /v1/Configuration
@returns(200) {account_sid: str?, default_chat_service_sid: str?, default_messaging_service_sid: str?, default_inactive_timer: str?, default_closed_timer: str?, url: str(uri)?, links: map?}

@endpoint POST /v1/Configuration
@returns(200) {account_sid: str?, default_chat_service_sid: str?, default_messaging_service_sid: str?, default_inactive_timer: str?, default_closed_timer: str?, url: str(uri)?, links: map?}

@endpoint GET /v1/Configuration/Addresses
@optional {Type: str, PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {address_configurations: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Configuration/Addresses
@returns(201) {sid: str?, account_sid: str?, type: str?, address: str?, friendly_name: str?, auto_creation: any?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, address_country: str?}

@endpoint GET /v1/Configuration/Addresses/{Sid}
@required {Sid: str}
@returns(200) {sid: str?, account_sid: str?, type: str?, address: str?, friendly_name: str?, auto_creation: any?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, address_country: str?}

@endpoint POST /v1/Configuration/Addresses/{Sid}
@required {Sid: str}
@returns(200) {sid: str?, account_sid: str?, type: str?, address: str?, friendly_name: str?, auto_creation: any?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, address_country: str?}

@endpoint DELETE /v1/Configuration/Addresses/{Sid}
@required {Sid: str}
@returns(204)

@endpoint GET /v1/Configuration/Webhooks
@returns(200) {account_sid: str?, method: str, filters: [str]?, pre_webhook_url: str?, post_webhook_url: str?, target: str, url: str(uri)?}

@endpoint POST /v1/Configuration/Webhooks
@returns(200) {account_sid: str?, method: str, filters: [str]?, pre_webhook_url: str?, post_webhook_url: str?, target: str, url: str(uri)?}

@endgroup

@group Conversations
@endpoint POST /v1/Conversations
@optional {X-Twilio-Webhook-Enabled: str}
@returns(201) {account_sid: str?, chat_service_sid: str?, messaging_service_sid: str?, sid: str?, friendly_name: str?, unique_name: str?, attributes: str?, state: str, date_created: str(date-time)?, date_updated: str(date-time)?, timers: any?, url: str(uri)?, links: map?, bindings: any?}

@endpoint GET /v1/Conversations
@optional {StartDate: str, EndDate: str, State: str, PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {conversations: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Conversations/{Sid}
@required {Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, messaging_service_sid: str?, sid: str?, friendly_name: str?, unique_name: str?, attributes: str?, state: str, date_created: str(date-time)?, date_updated: str(date-time)?, timers: any?, url: str(uri)?, links: map?, bindings: any?}

@endpoint DELETE /v1/Conversations/{Sid}
@required {Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(204)

@endpoint GET /v1/Conversations/{Sid}
@required {Sid: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, messaging_service_sid: str?, sid: str?, friendly_name: str?, unique_name: str?, attributes: str?, state: str, date_created: str(date-time)?, date_updated: str(date-time)?, timers: any?, url: str(uri)?, links: map?, bindings: any?}

@endpoint POST /v1/Conversations/{ConversationSid}/Messages
@required {ConversationSid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(201) {account_sid: str?, conversation_sid: str?, sid: str?, index: int, author: str?, body: str?, media: [any]?, attributes: str?, participant_sid: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, delivery: any?, links: map?, content_sid: str?}

@endpoint GET /v1/Conversations/{ConversationSid}/Messages
@required {ConversationSid: str}
@optional {Order: str, PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {messages: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Conversations/{ConversationSid}/Messages/{Sid}
@required {ConversationSid: str, Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(200) {account_sid: str?, conversation_sid: str?, sid: str?, index: int, author: str?, body: str?, media: [any]?, attributes: str?, participant_sid: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, delivery: any?, links: map?, content_sid: str?}

@endpoint DELETE /v1/Conversations/{ConversationSid}/Messages/{Sid}
@required {ConversationSid: str, Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(204)

@endpoint GET /v1/Conversations/{ConversationSid}/Messages/{Sid}
@required {ConversationSid: str, Sid: str}
@returns(200) {account_sid: str?, conversation_sid: str?, sid: str?, index: int, author: str?, body: str?, media: [any]?, attributes: str?, participant_sid: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, delivery: any?, links: map?, content_sid: str?}

@endpoint GET /v1/Conversations/{ConversationSid}/Messages/{MessageSid}/Receipts/{Sid}
@required {ConversationSid: str, MessageSid: str, Sid: str}
@returns(200) {account_sid: str?, conversation_sid: str?, sid: str?, message_sid: str?, channel_message_sid: str?, participant_sid: str?, status: str, error_code: int, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?}

@endpoint GET /v1/Conversations/{ConversationSid}/Messages/{MessageSid}/Receipts
@required {ConversationSid: str, MessageSid: str}
@optional {PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {delivery_receipts: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Conversations/{ConversationSid}/Participants
@required {ConversationSid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(201) {account_sid: str?, conversation_sid: str?, sid: str?, identity: str?, attributes: str?, messaging_binding: any?, role_sid: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, last_read_message_index: int?, last_read_timestamp: str?}

@endpoint GET /v1/Conversations/{ConversationSid}/Participants
@required {ConversationSid: str}
@optional {PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {participants: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Conversations/{ConversationSid}/Participants/{Sid}
@required {ConversationSid: str, Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(200) {account_sid: str?, conversation_sid: str?, sid: str?, identity: str?, attributes: str?, messaging_binding: any?, role_sid: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, last_read_message_index: int?, last_read_timestamp: str?}

@endpoint DELETE /v1/Conversations/{ConversationSid}/Participants/{Sid}
@required {ConversationSid: str, Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(204)

@endpoint GET /v1/Conversations/{ConversationSid}/Participants/{Sid}
@required {ConversationSid: str, Sid: str}
@returns(200) {account_sid: str?, conversation_sid: str?, sid: str?, identity: str?, attributes: str?, messaging_binding: any?, role_sid: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, last_read_message_index: int?, last_read_timestamp: str?}

@endpoint GET /v1/Conversations/{ConversationSid}/Webhooks
@required {ConversationSid: str}
@optional {PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {webhooks: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Conversations/{ConversationSid}/Webhooks
@required {ConversationSid: str}
@returns(201) {sid: str?, account_sid: str?, conversation_sid: str?, target: str?, url: str(uri)?, configuration: any?, date_created: str(date-time)?, date_updated: str(date-time)?}

@endpoint GET /v1/Conversations/{ConversationSid}/Webhooks/{Sid}
@required {ConversationSid: str, Sid: str}
@returns(200) {sid: str?, account_sid: str?, conversation_sid: str?, target: str?, url: str(uri)?, configuration: any?, date_created: str(date-time)?, date_updated: str(date-time)?}

@endpoint POST /v1/Conversations/{ConversationSid}/Webhooks/{Sid}
@required {ConversationSid: str, Sid: str}
@returns(200) {sid: str?, account_sid: str?, conversation_sid: str?, target: str?, url: str(uri)?, configuration: any?, date_created: str(date-time)?, date_updated: str(date-time)?}

@endpoint DELETE /v1/Conversations/{ConversationSid}/Webhooks/{Sid}
@required {ConversationSid: str, Sid: str}
@returns(204)

@endgroup

@group ConversationWithParticipants
@endpoint POST /v1/ConversationWithParticipants
@optional {X-Twilio-Webhook-Enabled: str}
@returns(201) {account_sid: str?, chat_service_sid: str?, messaging_service_sid: str?, sid: str?, friendly_name: str?, unique_name: str?, attributes: str?, state: str, date_created: str(date-time)?, date_updated: str(date-time)?, timers: any?, links: map?, bindings: any?, url: str(uri)?}
@returns(202) {account_sid: str?, chat_service_sid: str?, messaging_service_sid: str?, sid: str?, friendly_name: str?, unique_name: str?, attributes: str?, state: str, date_created: str(date-time)?, date_updated: str(date-time)?, timers: any?, links: map?, bindings: any?, url: str(uri)?}

@endgroup

@group Credentials
@endpoint POST /v1/Credentials
@returns(201) {sid: str?, account_sid: str?, friendly_name: str?, type: str, sandbox: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?}

@endpoint GET /v1/Credentials
@optional {PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {credentials: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Credentials/{Sid}
@required {Sid: str}
@returns(200) {sid: str?, account_sid: str?, friendly_name: str?, type: str, sandbox: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?}

@endpoint DELETE /v1/Credentials/{Sid}
@required {Sid: str}
@returns(204)

@endpoint GET /v1/Credentials/{Sid}
@required {Sid: str}
@returns(200) {sid: str?, account_sid: str?, friendly_name: str?, type: str, sandbox: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?}

@endgroup

@group ParticipantConversations
@endpoint GET /v1/ParticipantConversations
@optional {Identity: str, Address: str, PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {conversations: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endgroup

@group Roles
@endpoint POST /v1/Roles
@returns(201) {sid: str?, account_sid: str?, chat_service_sid: str?, friendly_name: str?, type: str, permissions: [str]?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?}

@endpoint GET /v1/Roles
@optional {PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {roles: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Roles/{Sid}
@required {Sid: str}
@returns(200) {sid: str?, account_sid: str?, chat_service_sid: str?, friendly_name: str?, type: str, permissions: [str]?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?}

@endpoint DELETE /v1/Roles/{Sid}
@required {Sid: str}
@returns(204)

@endpoint GET /v1/Roles/{Sid}
@required {Sid: str}
@returns(200) {sid: str?, account_sid: str?, chat_service_sid: str?, friendly_name: str?, type: str, permissions: [str]?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?}

@endgroup

@group Services
@endpoint POST /v1/Services
@returns(201) {account_sid: str?, sid: str?, friendly_name: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, links: map?}

@endpoint GET /v1/Services
@optional {PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {services: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint DELETE /v1/Services/{Sid}
@required {Sid: str}
@returns(204)

@endpoint GET /v1/Services/{Sid}
@required {Sid: str}
@returns(200) {account_sid: str?, sid: str?, friendly_name: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, links: map?}

@endpoint DELETE /v1/Services/{ChatServiceSid}/Bindings/{Sid}
@required {ChatServiceSid: str, Sid: str}
@returns(204)

@endpoint GET /v1/Services/{ChatServiceSid}/Bindings/{Sid}
@required {ChatServiceSid: str, Sid: str}
@returns(200) {sid: str?, account_sid: str?, chat_service_sid: str?, credential_sid: str?, date_created: str(date-time)?, date_updated: str(date-time)?, endpoint: str?, identity: str?, binding_type: str, message_types: [str]?, url: str(uri)?}

@endpoint GET /v1/Services/{ChatServiceSid}/Bindings
@required {ChatServiceSid: str}
@optional {BindingType: [str], Identity: [str], PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {bindings: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint GET /v1/Services/{ChatServiceSid}/Configuration
@required {ChatServiceSid: str}
@returns(200) {chat_service_sid: str?, default_conversation_creator_role_sid: str?, default_conversation_role_sid: str?, default_chat_service_role_sid: str?, url: str(uri)?, links: map?, reachability_enabled: bool?}

@endpoint POST /v1/Services/{ChatServiceSid}/Configuration
@required {ChatServiceSid: str}
@returns(200) {chat_service_sid: str?, default_conversation_creator_role_sid: str?, default_conversation_role_sid: str?, default_chat_service_role_sid: str?, url: str(uri)?, links: map?, reachability_enabled: bool?}

@endpoint POST /v1/Services/{ChatServiceSid}/Conversations
@required {ChatServiceSid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(201) {account_sid: str?, chat_service_sid: str?, messaging_service_sid: str?, sid: str?, friendly_name: str?, unique_name: str?, attributes: str?, state: str, date_created: str(date-time)?, date_updated: str(date-time)?, timers: any?, url: str(uri)?, links: map?, bindings: any?}

@endpoint GET /v1/Services/{ChatServiceSid}/Conversations
@required {ChatServiceSid: str}
@optional {StartDate: str, EndDate: str, State: str, PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {conversations: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Services/{ChatServiceSid}/Conversations/{Sid}
@required {ChatServiceSid: str, Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, messaging_service_sid: str?, sid: str?, friendly_name: str?, unique_name: str?, attributes: str?, state: str, date_created: str(date-time)?, date_updated: str(date-time)?, timers: any?, url: str(uri)?, links: map?, bindings: any?}

@endpoint DELETE /v1/Services/{ChatServiceSid}/Conversations/{Sid}
@required {ChatServiceSid: str, Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(204)

@endpoint GET /v1/Services/{ChatServiceSid}/Conversations/{Sid}
@required {ChatServiceSid: str, Sid: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, messaging_service_sid: str?, sid: str?, friendly_name: str?, unique_name: str?, attributes: str?, state: str, date_created: str(date-time)?, date_updated: str(date-time)?, timers: any?, url: str(uri)?, links: map?, bindings: any?}

@endpoint POST /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages
@required {ChatServiceSid: str, ConversationSid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(201) {account_sid: str?, chat_service_sid: str?, conversation_sid: str?, sid: str?, index: int, author: str?, body: str?, media: [any]?, attributes: str?, participant_sid: str?, date_created: str(date-time)?, date_updated: str(date-time)?, delivery: any?, url: str(uri)?, links: map?, content_sid: str?}

@endpoint GET /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages
@required {ChatServiceSid: str, ConversationSid: str}
@optional {Order: str, PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {messages: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages/{Sid}
@required {ChatServiceSid: str, ConversationSid: str, Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, conversation_sid: str?, sid: str?, index: int, author: str?, body: str?, media: [any]?, attributes: str?, participant_sid: str?, date_created: str(date-time)?, date_updated: str(date-time)?, delivery: any?, url: str(uri)?, links: map?, content_sid: str?}

@endpoint DELETE /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages/{Sid}
@required {ChatServiceSid: str, ConversationSid: str, Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(204)

@endpoint GET /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages/{Sid}
@required {ChatServiceSid: str, ConversationSid: str, Sid: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, conversation_sid: str?, sid: str?, index: int, author: str?, body: str?, media: [any]?, attributes: str?, participant_sid: str?, date_created: str(date-time)?, date_updated: str(date-time)?, delivery: any?, url: str(uri)?, links: map?, content_sid: str?}

@endpoint GET /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages/{MessageSid}/Receipts/{Sid}
@required {ChatServiceSid: str, ConversationSid: str, MessageSid: str, Sid: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, conversation_sid: str?, message_sid: str?, sid: str?, channel_message_sid: str?, participant_sid: str?, status: str, error_code: int, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?}

@endpoint GET /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages/{MessageSid}/Receipts
@required {ChatServiceSid: str, ConversationSid: str, MessageSid: str}
@optional {PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {delivery_receipts: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Participants
@required {ChatServiceSid: str, ConversationSid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(201) {account_sid: str?, chat_service_sid: str?, conversation_sid: str?, sid: str?, identity: str?, attributes: str?, messaging_binding: any?, role_sid: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, last_read_message_index: int?, last_read_timestamp: str?}

@endpoint GET /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Participants
@required {ChatServiceSid: str, ConversationSid: str}
@optional {PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {participants: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Participants/{Sid}
@required {ChatServiceSid: str, ConversationSid: str, Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, conversation_sid: str?, sid: str?, identity: str?, attributes: str?, messaging_binding: any?, role_sid: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, last_read_message_index: int?, last_read_timestamp: str?}

@endpoint DELETE /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Participants/{Sid}
@required {ChatServiceSid: str, ConversationSid: str, Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(204)

@endpoint GET /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Participants/{Sid}
@required {ChatServiceSid: str, ConversationSid: str, Sid: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, conversation_sid: str?, sid: str?, identity: str?, attributes: str?, messaging_binding: any?, role_sid: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, last_read_message_index: int?, last_read_timestamp: str?}

@endpoint POST /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Webhooks
@required {ChatServiceSid: str, ConversationSid: str}
@returns(201) {sid: str?, account_sid: str?, chat_service_sid: str?, conversation_sid: str?, target: str?, url: str(uri)?, configuration: any?, date_created: str(date-time)?, date_updated: str(date-time)?}

@endpoint GET /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Webhooks
@required {ChatServiceSid: str, ConversationSid: str}
@optional {PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {webhooks: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Webhooks/{Sid}
@required {ChatServiceSid: str, ConversationSid: str, Sid: str}
@returns(200) {sid: str?, account_sid: str?, chat_service_sid: str?, conversation_sid: str?, target: str?, url: str(uri)?, configuration: any?, date_created: str(date-time)?, date_updated: str(date-time)?}

@endpoint DELETE /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Webhooks/{Sid}
@required {ChatServiceSid: str, ConversationSid: str, Sid: str}
@returns(204)

@endpoint GET /v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Webhooks/{Sid}
@required {ChatServiceSid: str, ConversationSid: str, Sid: str}
@returns(200) {sid: str?, account_sid: str?, chat_service_sid: str?, conversation_sid: str?, target: str?, url: str(uri)?, configuration: any?, date_created: str(date-time)?, date_updated: str(date-time)?}

@endpoint POST /v1/Services/{ChatServiceSid}/ConversationWithParticipants
@required {ChatServiceSid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(201) {account_sid: str?, chat_service_sid: str?, messaging_service_sid: str?, sid: str?, friendly_name: str?, unique_name: str?, attributes: str?, state: str, date_created: str(date-time)?, date_updated: str(date-time)?, timers: any?, links: map?, bindings: any?, url: str(uri)?}
@returns(202) {account_sid: str?, chat_service_sid: str?, messaging_service_sid: str?, sid: str?, friendly_name: str?, unique_name: str?, attributes: str?, state: str, date_created: str(date-time)?, date_updated: str(date-time)?, timers: any?, links: map?, bindings: any?, url: str(uri)?}

@endpoint POST /v1/Services/{ChatServiceSid}/Configuration/Notifications
@required {ChatServiceSid: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, new_message: any?, added_to_conversation: any?, removed_from_conversation: any?, log_enabled: bool?, url: str(uri)?}

@endpoint GET /v1/Services/{ChatServiceSid}/Configuration/Notifications
@required {ChatServiceSid: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, new_message: any?, added_to_conversation: any?, removed_from_conversation: any?, log_enabled: bool?, url: str(uri)?}

@endpoint GET /v1/Services/{ChatServiceSid}/ParticipantConversations
@required {ChatServiceSid: str}
@optional {Identity: str, Address: str, PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {conversations: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Services/{ChatServiceSid}/Roles
@required {ChatServiceSid: str}
@returns(201) {sid: str?, account_sid: str?, chat_service_sid: str?, friendly_name: str?, type: str, permissions: [str]?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?}

@endpoint GET /v1/Services/{ChatServiceSid}/Roles
@required {ChatServiceSid: str}
@optional {PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {roles: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Services/{ChatServiceSid}/Roles/{Sid}
@required {ChatServiceSid: str, Sid: str}
@returns(200) {sid: str?, account_sid: str?, chat_service_sid: str?, friendly_name: str?, type: str, permissions: [str]?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?}

@endpoint DELETE /v1/Services/{ChatServiceSid}/Roles/{Sid}
@required {ChatServiceSid: str, Sid: str}
@returns(204)

@endpoint GET /v1/Services/{ChatServiceSid}/Roles/{Sid}
@required {ChatServiceSid: str, Sid: str}
@returns(200) {sid: str?, account_sid: str?, chat_service_sid: str?, friendly_name: str?, type: str, permissions: [str]?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?}

@endpoint POST /v1/Services/{ChatServiceSid}/Users
@required {ChatServiceSid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(201) {sid: str?, account_sid: str?, chat_service_sid: str?, role_sid: str?, identity: str?, friendly_name: str?, attributes: str?, is_online: bool?, is_notifiable: bool?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, links: map?}

@endpoint GET /v1/Services/{ChatServiceSid}/Users
@required {ChatServiceSid: str}
@optional {PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {users: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Services/{ChatServiceSid}/Users/{Sid}
@required {ChatServiceSid: str, Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(200) {sid: str?, account_sid: str?, chat_service_sid: str?, role_sid: str?, identity: str?, friendly_name: str?, attributes: str?, is_online: bool?, is_notifiable: bool?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, links: map?}

@endpoint DELETE /v1/Services/{ChatServiceSid}/Users/{Sid}
@required {ChatServiceSid: str, Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(204)

@endpoint GET /v1/Services/{ChatServiceSid}/Users/{Sid}
@required {ChatServiceSid: str, Sid: str}
@returns(200) {sid: str?, account_sid: str?, chat_service_sid: str?, role_sid: str?, identity: str?, friendly_name: str?, attributes: str?, is_online: bool?, is_notifiable: bool?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, links: map?}

@endpoint POST /v1/Services/{ChatServiceSid}/Users/{UserSid}/Conversations/{ConversationSid}
@required {ChatServiceSid: str, UserSid: str, ConversationSid: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, conversation_sid: str?, unread_messages_count: int?, last_read_message_index: int?, participant_sid: str?, user_sid: str?, friendly_name: str?, conversation_state: str, timers: any?, attributes: str?, date_created: str(date-time)?, date_updated: str(date-time)?, created_by: str?, notification_level: str, unique_name: str?, url: str(uri)?, links: map?}

@endpoint DELETE /v1/Services/{ChatServiceSid}/Users/{UserSid}/Conversations/{ConversationSid}
@required {ChatServiceSid: str, UserSid: str, ConversationSid: str}
@returns(204)

@endpoint GET /v1/Services/{ChatServiceSid}/Users/{UserSid}/Conversations/{ConversationSid}
@required {ChatServiceSid: str, UserSid: str, ConversationSid: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, conversation_sid: str?, unread_messages_count: int?, last_read_message_index: int?, participant_sid: str?, user_sid: str?, friendly_name: str?, conversation_state: str, timers: any?, attributes: str?, date_created: str(date-time)?, date_updated: str(date-time)?, created_by: str?, notification_level: str, unique_name: str?, url: str(uri)?, links: map?}

@endpoint GET /v1/Services/{ChatServiceSid}/Users/{UserSid}/Conversations
@required {ChatServiceSid: str, UserSid: str}
@optional {PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {conversations: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Services/{ChatServiceSid}/Configuration/Webhooks
@required {ChatServiceSid: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, pre_webhook_url: str(uri)?, post_webhook_url: str(uri)?, filters: [str]?, method: str, url: str(uri)?}

@endpoint GET /v1/Services/{ChatServiceSid}/Configuration/Webhooks
@required {ChatServiceSid: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, pre_webhook_url: str(uri)?, post_webhook_url: str(uri)?, filters: [str]?, method: str, url: str(uri)?}

@endgroup

@group Users
@endpoint POST /v1/Users
@optional {X-Twilio-Webhook-Enabled: str}
@returns(201) {sid: str?, account_sid: str?, chat_service_sid: str?, role_sid: str?, identity: str?, friendly_name: str?, attributes: str?, is_online: bool?, is_notifiable: bool?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, links: map?}

@endpoint GET /v1/Users
@optional {PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {users: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endpoint POST /v1/Users/{Sid}
@required {Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(200) {sid: str?, account_sid: str?, chat_service_sid: str?, role_sid: str?, identity: str?, friendly_name: str?, attributes: str?, is_online: bool?, is_notifiable: bool?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, links: map?}

@endpoint DELETE /v1/Users/{Sid}
@required {Sid: str}
@optional {X-Twilio-Webhook-Enabled: str}
@returns(204)

@endpoint GET /v1/Users/{Sid}
@required {Sid: str}
@returns(200) {sid: str?, account_sid: str?, chat_service_sid: str?, role_sid: str?, identity: str?, friendly_name: str?, attributes: str?, is_online: bool?, is_notifiable: bool?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?, links: map?}

@endpoint POST /v1/Users/{UserSid}/Conversations/{ConversationSid}
@required {UserSid: str, ConversationSid: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, conversation_sid: str?, unread_messages_count: int?, last_read_message_index: int?, participant_sid: str?, user_sid: str?, friendly_name: str?, conversation_state: str, timers: any?, attributes: str?, date_created: str(date-time)?, date_updated: str(date-time)?, created_by: str?, notification_level: str, unique_name: str?, url: str(uri)?, links: map?}

@endpoint DELETE /v1/Users/{UserSid}/Conversations/{ConversationSid}
@required {UserSid: str, ConversationSid: str}
@returns(204)

@endpoint GET /v1/Users/{UserSid}/Conversations/{ConversationSid}
@required {UserSid: str, ConversationSid: str}
@returns(200) {account_sid: str?, chat_service_sid: str?, conversation_sid: str?, unread_messages_count: int?, last_read_message_index: int?, participant_sid: str?, user_sid: str?, friendly_name: str?, conversation_state: str, timers: any?, attributes: str?, date_created: str(date-time)?, date_updated: str(date-time)?, created_by: str?, notification_level: str, unique_name: str?, url: str(uri)?, links: map?}

@endpoint GET /v1/Users/{UserSid}/Conversations
@required {UserSid: str}
@optional {PageSize: int(int64), Page: int, PageToken: str}
@returns(200) {conversations: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}}

@endgroup

@end