openapi: 3.1.0 info: title: Compatibility API version: 1.0.0 tags: - name: Tokens description: Manage API tokens for authentication. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Recording Transcriptions description: Manage transcriptions of recordings. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Recordings description: Manage call recordings. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Queue Members description: Manage members in call queues. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Queues description: Manage call queues. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Message Media description: Manage media files attached to messages. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Messages description: Send and manage SMS/MMS messages. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Imported Phone Numbers description: Import phone numbers hosted elsewhere into your SignalWire Space. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Incoming Phone Numbers description: Manage phone numbers in your project. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Fax Media description: Manage fax media files. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Faxes description: Send and manage faxes. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: CXML Scripts description: Manage cXML scripts for storing XML instructions. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Conference Streams description: Manage media streams for conferences. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Conference Recordings description: Manage recordings for conference calls. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Conference Participants description: Manage participants in conference calls. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Conferences description: Manage conference calls. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Streams description: Manage media streams for calls. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Calls description: Manage voice calls and call recordings. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Available Phone Numbers description: Search for available phone numbers to purchase. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Applications description: Manage cXML applications for handling voice and messaging. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API - name: Accounts description: Manage SignalWire projects and subprojects. externalDocs: url: https://signalwire.com/docs/compatibility-api/rest description: Developer documentation on the Compatibility REST API paths: /Accounts: get: operationId: list_accounts summary: List Accounts description: |- This endpoint will return a list that contains Project you are connecting as and any subprojects. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Management_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - name: FriendlyName in: query required: false description: 'A named unique identifier for the resource. Allowed characters: `A-Za-z0-9_-`. Maximum of 100 characters.' schema: type: string explode: false - name: Page in: query required: false description: The page number to retrieve. Page numbers are zero-indexed, so the first page is 0. schema: type: integer format: int32 minimum: 0 default: 0 explode: false - name: PageSize in: query required: false description: The number of results to return per page. The default is 50, and the maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: A token used to retrieve a specific page of results. The token is returned in the response of a previous request. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/AccountListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Accounts post: operationId: create_subprojects summary: Create Subprojects description: |- This endpoint creates a subproject on the Project you are connecting as. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Management_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: [] responses: '201': description: Response containing a newly created subproject account. content: application/json: schema: $ref: '#/components/schemas/Account' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Accounts requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/CreateSubprojectRequest' /Accounts/{AccountSid}/Applications: get: operationId: list_applications summary: List Applications description: |- The ability to read all of the applications that are associated with your Account. This will be returned as a list of applications. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_ or _Messaging_ or _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/AccountSidPath' - name: FriendlyName in: query required: false description: Filter by a named unique identifier for the resource. schema: type: string explode: false - name: Page in: query required: false description: The page number to retrieve. Page numbers are zero-indexed, so the first page is 0. schema: type: integer format: int32 minimum: 0 default: 0 explode: false - name: PageSize in: query required: false description: The number of results to return per page. The default is 50, and the maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: A token used to retrieve a specific page of results. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ApplicationListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Applications post: operationId: create_application summary: Create an Application description: |- Create an Application. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_ or _Messaging_ or _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/AccountSidPath' responses: '201': description: Response containing a newly created application. content: application/json: schema: $ref: '#/components/schemas/Application' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Applications requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/CreateApplicationRequest' /Accounts/{AccountSid}/Applications/{Sid}: get: operationId: get_application summary: Find an Application by ID description: |- Find an Application by ID. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_ or _Messaging_ or _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/AccountSidPath' - $ref: '#/components/parameters/ApplicationPathSid' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ApplicationResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Applications post: operationId: update_application summary: Update an Application description: |- Update an Application. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_ or _Messaging_ or _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/AccountSidPath' - $ref: '#/components/parameters/ApplicationPathSid' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ApplicationResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Applications requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UpdateApplicationRequest' delete: operationId: delete_application summary: Delete an Application description: |- Delete an Application. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_ or _Messaging_ or _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/AccountSidPath' - $ref: '#/components/parameters/ApplicationPathSid' responses: '204': description: 204 No Content response. '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Applications /Accounts/{AccountSid}/AvailablePhoneNumbers: get: operationId: list_available_phone_number_resources summary: List of AvailablePhoneNumber resources description: |- Returns a list of URIs to phone number resources available to the account, categorized by type (Local, Toll-Free, Mobile, etc) and ISO country. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/AvailablePhoneNumbersAccountSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/AvailablePhoneNumberResourcesResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Available Phone Numbers /Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountry}: get: operationId: list_available_phone_number_resources_by_country summary: List of AvailablePhoneNumber resources by country description: |- Returns a list of URIs to phone number resources available to the account in the specified ISO country, categorized by type (Local, Toll-Free, Mobile, etc). #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/AvailablePhoneNumbersAccountSidPath' - $ref: '#/components/parameters/IsoCountryPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/AvailablePhoneNumberByCountryResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Available Phone Numbers /Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountry}/Local: get: operationId: search_local_available_phone_numbers summary: Search for available phone numbers that match your criteria. description: |- Search for Local AvailablePhoneNumbers. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/AvailablePhoneNumbersAccountSidPath' - $ref: '#/components/parameters/IsoCountryPath' - name: AreaCode in: query required: false description: Find numbers in the provided area code. Only available for numbers in US and Canada. schema: type: string explode: false - name: Beta in: query required: false description: New numbers on SignalWire are marked as `beta`. schema: type: boolean explode: false - name: Contains in: query required: false description: Find numbers based off of a pattern. Valid characters are `[0-9a-zA-Z]`. schema: type: string explode: false - name: ExcludeAllAddressRequired in: query required: false description: Accepted for Twilio compatibility but has no effect on the response. schema: type: boolean explode: false - name: ExcludeForeignAddressRequired in: query required: false description: Accepted for Twilio compatibility but has no effect on the response. schema: type: boolean explode: false - name: ExcludeLocalAddressRequired in: query required: false description: Accepted for Twilio compatibility but has no effect on the response. schema: type: boolean explode: false - name: FaxEnabled in: query required: false description: Not supported. Accepted for Twilio API compatibility. schema: type: boolean explode: false - name: InLocality in: query required: false description: Limits search to a city/locality. Requires InRegion to also be set. schema: type: string explode: false - name: InRegion in: query required: false description: Limits search to same region as number. Must be a two-letter state/province code. schema: type: string explode: false - name: MmsEnabled in: query required: false description: Not supported. Accepted for Twilio API compatibility. schema: type: boolean explode: false - name: SmsEnabled in: query required: false description: Not supported. Accepted for Twilio API compatibility. schema: type: boolean explode: false - name: VoiceEnabled in: query required: false description: Not supported. Accepted for Twilio API compatibility. schema: type: boolean explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/AvailablePhoneNumberListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Available Phone Numbers /Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountry}/TollFree: get: operationId: search_toll_free_available_phone_numbers summary: Find toll-free numbers description: |- Search for toll-free AvailablePhoneNumbers. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/AvailablePhoneNumbersAccountSidPath' - $ref: '#/components/parameters/IsoCountryPath' - name: AreaCode in: query required: false description: Find numbers in the provided area code. Only available for numbers in US and Canada. schema: type: string explode: false - name: Beta in: query required: false description: New numbers on SignalWire are marked as `beta`. schema: type: boolean explode: false - name: Contains in: query required: false description: Find numbers based off of a pattern. Valid characters are `[0-9a-zA-Z]`. schema: type: string explode: false - name: ExcludeAllAddressRequired in: query required: false description: Accepted for Twilio compatibility but has no effect on the response. schema: type: boolean explode: false - name: ExcludeForeignAddressRequired in: query required: false description: Accepted for Twilio compatibility but has no effect on the response. schema: type: boolean explode: false - name: ExcludeLocalAddressRequired in: query required: false description: Accepted for Twilio compatibility but has no effect on the response. schema: type: boolean explode: false - name: FaxEnabled in: query required: false description: Not supported. Accepted for Twilio API compatibility. schema: type: boolean explode: false - name: InLocality in: query required: false description: Limits search to a city/locality. Requires InRegion to also be set. schema: type: string explode: false - name: InRegion in: query required: false description: Limits search to same region as number. Must be a two-letter state/province code. schema: type: string explode: false - name: MmsEnabled in: query required: false description: Not supported. Accepted for Twilio API compatibility. schema: type: boolean explode: false - name: SmsEnabled in: query required: false description: Not supported. Accepted for Twilio API compatibility. schema: type: boolean explode: false - name: VoiceEnabled in: query required: false description: Not supported. Accepted for Twilio API compatibility. schema: type: boolean explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/AvailablePhoneNumberListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Available Phone Numbers /Accounts/{AccountSid}/Calls: get: operationId: list_all_calls summary: List all Calls description: |- List all calls. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/CallsAccountSidPath' - name: EndTime in: query required: false description: The time, in RFC 2822 GMT format, on which the call was terminated. schema: type: string explode: false - name: EndTime< in: query required: false description: The time before which the call was terminated. schema: type: string explode: false - name: EndTime> in: query required: false description: The time after which the call was terminated. schema: type: string explode: false - name: From in: query required: false description: The address that initiated the call. schema: type: string explode: false - name: ParentCallSid in: query required: false description: The unique identifier for the call that created this call. schema: $ref: '#/components/schemas/uuid' explode: false - name: StartTime in: query required: false description: The time, in RFC 2822 GMT format, on which the call began. schema: type: string explode: false - name: StartTime< in: query required: false description: The time before which the call began. schema: type: string explode: false - name: StartTime> in: query required: false description: The time after which the call began. schema: type: string explode: false - name: Status in: query required: false description: The status of the call. schema: type: string enum: - queued - ringing - in-progress - canceled - completed - busy - failed - no-answer explode: false - name: To in: query required: false description: The address that received the call. schema: type: string explode: false - name: Page in: query required: false description: The page number to retrieve. Page numbers are zero-indexed, so the first page is 0. schema: type: integer format: int32 minimum: 0 default: 0 explode: false - name: PageSize in: query required: false description: The number of results to return per page. The default is 50, and the maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: A token used to retrieve a specific page of results. Must start with PA or PB. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/CallListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Calls post: operationId: create_a_call summary: Create a Call description: |- Create a call. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/CallsAccountSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/CallResponse' '400': description: The request was invalid. Review the errors array for specific issues with your request. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorArrayResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Calls requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/CreateCallRequest' /Accounts/{AccountSid}/Calls/{CallSid}/Recordings: post: operationId: create_recording summary: Create a Recording description: |- Create a recording. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/CallsAccountSidPath' - $ref: '#/components/parameters/CallSidPathForRecording' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/CallRecordingResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '503': description: The service is temporarily unavailable. Please try again later. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Recordings requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/CreateCallRecordingRequest' /Accounts/{AccountSid}/Calls/{CallSid}/Recordings/{Sid}: post: operationId: update_recording summary: Update a Recording description: |- Pause, resume or stop a Recording. You can control what happens while recording is paused (replace pause with silence or skip it). #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/CallsAccountSidPath' - $ref: '#/components/parameters/CallSidPathForRecording' - $ref: '#/components/parameters/CallSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/CallRecordingResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '503': description: The service is temporarily unavailable. Please try again later. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Recordings requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UpdateCallRecordingRequest' /Accounts/{AccountSid}/Calls/{CallSid}/Streams: post: operationId: create_stream summary: Create a Stream description: |- Create a stream. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/CallsAccountSidPath' - $ref: '#/components/parameters/CallSidPathForRecording' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/CallStreamResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '503': description: The service is temporarily unavailable. Please try again later. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Streams requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/CreateCallStreamRequest' /Accounts/{AccountSid}/Calls/{CallSid}/Streams/{Sid}: post: operationId: update_stream summary: Stop a Stream description: |- Stop a Stream. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/CallsAccountSidPath' - $ref: '#/components/parameters/CallSidPathForRecording' - $ref: '#/components/parameters/CallSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/CallStreamResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '503': description: The service is temporarily unavailable. Please try again later. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Streams requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UpdateCallStreamRequest' /Accounts/{AccountSid}/Calls/{Sid}: get: operationId: retrieve_a_call summary: Retrieve a Call description: |- Retrieve a call. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/CallsAccountSidPath' - $ref: '#/components/parameters/CallSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/CallResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Calls post: operationId: update_a_call summary: Update a Call description: |- Update a call. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/CallsAccountSidPath' - $ref: '#/components/parameters/CallSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/CallResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '503': description: The service is temporarily unavailable. Please try again later. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Calls requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UpdateCallRequest' delete: operationId: delete_a_call summary: Delete a Call description: |- Delete a call record from your account. If the delete is successful, a 204 response, with no body, will be returned. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/CallsAccountSidPath' - $ref: '#/components/parameters/CallSidPath' responses: '204': description: 204 No Content response. '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Calls /Accounts/{AccountSid}/Conferences: get: operationId: list_all_conferences summary: List All Conferences description: |- The ability to read all of the conferences that are associated with your Account. This will be returned as a list of conferences. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/ConferencesAccountSidPath' - name: DateCreated in: query required: false description: 'Shows conferences that were created on the date provided. Format: YYYY-MM-DD.' schema: type: string explode: false - name: DateCreated< in: query required: false description: 'Shows conferences that were created before the date provided. Format: YYYY-MM-DD.' schema: type: string explode: false - name: DateCreated> in: query required: false description: 'Shows conferences that were created after the date provided. Format: YYYY-MM-DD.' schema: type: string explode: false - name: DateUpdated in: query required: false description: 'Shows conferences that were updated on the date provided. Format: YYYY-MM-DD.' schema: type: string explode: false - name: DateUpdated< in: query required: false description: 'Shows conferences that were updated before the date provided. Format: YYYY-MM-DD.' schema: type: string explode: false - name: DateUpdated> in: query required: false description: 'Shows conferences that were updated after the date provided. Format: YYYY-MM-DD.' schema: type: string explode: false - name: FriendlyName in: query required: false description: A description, up to 64 characters, of the conference room. schema: type: string maxLength: 64 explode: false - name: Status in: query required: false description: The status of this conference. schema: $ref: '#/components/schemas/ConferenceStatus' explode: false - name: Page in: query required: false description: The page number to retrieve. Page numbers are zero-indexed, so the first page is 0. schema: type: integer format: int32 minimum: 0 default: 0 explode: false - name: PageSize in: query required: false description: The number of results to return per page. The default is 50, and the maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: A token used to retrieve a specific page of results. Must start with PA or PB. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ConferenceListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Conferences /Accounts/{AccountSid}/Conferences/{ConferenceSid}/Participants: get: operationId: list_all_participants summary: List all active Participants description: |- The ability to read all of the active participants that are associated with this conference call. This will be returned as a list of participants. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/ConferencesAccountSidPath' - $ref: '#/components/parameters/ConferenceSidPathForParticipant' - name: Muted in: query required: false description: Whether or not a participant is muted. schema: type: boolean explode: false - name: Hold in: query required: false description: Whether or not a participant is on hold. schema: type: boolean explode: false - name: Page in: query required: false description: The page number to retrieve. Page numbers are zero-indexed, so the first page is 0. schema: type: integer format: int32 minimum: 0 default: 0 explode: false - name: PageSize in: query required: false description: The number of results to return per page. The default is 50, and the maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: A token used to retrieve a specific page of results. Must start with PA or PB. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ConferenceParticipantListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Conference Participants /Accounts/{AccountSid}/Conferences/{ConferenceSid}/Participants/{CallSid}: get: operationId: retrieve_participant summary: Retrieve a Participant description: |- Retrieve a single participant. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/ConferencesAccountSidPath' - $ref: '#/components/parameters/ConferenceSidPathForParticipant' - $ref: '#/components/parameters/ParticipantCallSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ConferenceParticipantResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Conference Participants post: operationId: update_participant summary: Update a Participant description: |- Update a participant. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/ConferencesAccountSidPath' - $ref: '#/components/parameters/ConferenceSidPathForParticipant' - $ref: '#/components/parameters/ParticipantCallSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ConferenceParticipantResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Conference Participants requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UpdateConferenceParticipantRequest' delete: operationId: delete_participant summary: Delete a Participant description: |- Deleting a participant will take them out of a conference call. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/ConferencesAccountSidPath' - $ref: '#/components/parameters/ConferenceSidPathForParticipant' - $ref: '#/components/parameters/ParticipantCallSidPath' responses: '204': description: 204 No Content response. '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Conference Participants /Accounts/{AccountSid}/Conferences/{ConferenceSid}/Recordings: get: operationId: list_conference_recordings summary: List Conference Recordings description: |- List all recordings for a conference. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/ConferencesAccountSidPath' - $ref: '#/components/parameters/ConferenceSidPathForParticipant' - name: DateCreated in: query required: false description: 'Shows recordings that were created on the date provided. Format: YYYY-MM-DD.' schema: type: string explode: false - name: DateCreated< in: query required: false description: 'Shows recordings that were created before the date provided. Format: YYYY-MM-DD.' schema: type: string explode: false - name: DateCreated> in: query required: false description: 'Shows recordings that were created after the date provided. Format: YYYY-MM-DD.' schema: type: string explode: false - name: Page in: query required: false description: The page number to retrieve. Page numbers are zero-indexed, so the first page is 0. schema: type: integer format: int32 minimum: 0 default: 0 explode: false - name: PageSize in: query required: false description: The number of results to return per page. The default is 50, and the maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: A token used to retrieve a specific page of results. Must start with PA or PB. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ConferenceRecordingListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Conference Recordings /Accounts/{AccountSid}/Conferences/{ConferenceSid}/Recordings/{Sid}: get: operationId: get_conference_recording summary: Get a Conference Recording description: |- Get details for a specific conference recording. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/ConferencesAccountSidPath' - $ref: '#/components/parameters/ConferenceSidPathForParticipant' - $ref: '#/components/parameters/ConferenceRecordingSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ConferenceRecordingResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Conference Recordings post: operationId: update_conference_recording summary: Update a Conference Recording description: |- Pause, resume or stop a conference recording. You can control what happens while recording is paused (replace pause with silence or skip it). #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/ConferencesAccountSidPath' - $ref: '#/components/parameters/ConferenceSidPathForParticipant' - $ref: '#/components/parameters/ConferenceRecordingSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ConferenceRecordingResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Review the errors array for specific issues. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorStringArrayResponse' '503': description: The service is temporarily unavailable. Please try again later. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Conference Recordings requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UpdateConferenceRecordingRequest' delete: operationId: delete_conference_recording summary: Delete a Conference Recording description: |- Delete a conference recording. If successful, a 204 response with no body will be returned. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/ConferencesAccountSidPath' - $ref: '#/components/parameters/ConferenceSidPathForParticipant' - $ref: '#/components/parameters/ConferenceRecordingSidPath' responses: '204': description: 204 No Content response. '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Conference Recordings /Accounts/{AccountSid}/Conferences/{ConferenceSid}/Streams: post: operationId: create_conference_stream summary: Create a Conference Stream description: |- Create a stream for an existing conference. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/ConferencesAccountSidPath' - $ref: '#/components/parameters/ConferenceSidPathForParticipant' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ConferenceStreamResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Review the errors array for specific issues. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorStringArrayResponse' tags: - Conference Streams requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/CreateConferenceStreamRequest' /Accounts/{AccountSid}/Conferences/{ConferenceSid}/Streams/{Sid}: post: operationId: update_conference_stream summary: Update Conference Stream description: |- Update an existing conference stream. Commonly used to stop/start streams or modify stream properties. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/ConferencesAccountSidPath' - $ref: '#/components/parameters/ConferenceSidPathForParticipant' - $ref: '#/components/parameters/ConferenceStreamSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ConferenceStreamResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Review the errors array for specific issues. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorStringArrayResponse' tags: - Conference Streams requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UpdateConferenceStreamRequest' /Accounts/{AccountSid}/Conferences/{Sid}: get: operationId: retrieve_conference summary: Retrieve a Conference description: |- Retrieve a single conference. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/ConferencesAccountSidPath' - $ref: '#/components/parameters/ConferenceSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ConferenceResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Conferences post: operationId: update_conference summary: Update Conference description: |- Allows you to modify the properties of a conference. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/ConferencesAccountSidPath' - $ref: '#/components/parameters/ConferenceSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ConferenceResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '503': description: The service is temporarily unavailable. Please try again later. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Conferences requestBody: required: false content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UpdateConferenceRequest' /Accounts/{AccountSid}/Faxes: get: operationId: list_all_faxes summary: List all Faxes description: |- List all faxes. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/FaxesAccountSidPath' - name: Page in: query required: false description: The page index to retrieve. Zero-indexed. schema: type: integer format: int32 minimum: 0 default: 0 explode: false - name: PageSize in: query required: false description: The number of results per page. Default is 50, maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: Token for cursor-based pagination. Required when Page > 0. schema: type: string explode: false - name: DateCreatedAfter in: query required: false description: The date, in ISO 8601 format, after which the fax was sent. schema: type: string explode: false - name: DateCreatedOnOrBefore in: query required: false description: The date, in ISO 8601 format, on or before which the fax was sent. schema: type: string explode: false - name: From in: query required: false description: The phone number, in E.164 format, the fax was sent from. schema: type: string explode: false - name: To in: query required: false description: The phone number, in E.164 format, the fax was sent to. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/FaxListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Faxes post: operationId: send_fax summary: Send a Fax description: |- Send a fax. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/FaxesAccountSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/FaxResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Faxes requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/SendFaxRequest' /Accounts/{AccountSid}/Faxes/{FaxSid}/Media: get: operationId: list_all_fax_media summary: List Fax Media description: |- List all media for a fax. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/FaxesAccountSidPath' - $ref: '#/components/parameters/FaxSidPathForMedia' - name: Page in: query required: false description: The page index to retrieve. Zero-indexed. schema: type: integer format: int32 minimum: 0 default: 0 explode: false - name: PageSize in: query required: false description: The number of results per page. Default is 50, maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: Token for cursor-based pagination. Required when Page > 0. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/FaxMediaListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Fax Media /Accounts/{AccountSid}/Faxes/{FaxSid}/Media/{Sid}: get: operationId: retrieve_medias summary: Retrieve Fax Media description: |- Retrieve media for a fax. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/FaxesAccountSidPath' - $ref: '#/components/parameters/FaxSidPathForMedia' - $ref: '#/components/parameters/FaxSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/FaxMediaResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Fax Media delete: operationId: delete_fax_media summary: Delete Fax Media description: |- Delete media for a fax. Cannot delete media for a fax that is in progress (queued, processing, sending, or receiving). #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/FaxesAccountSidPath' - $ref: '#/components/parameters/FaxSidPathForMedia' - $ref: '#/components/parameters/FaxSidPath' responses: '204': description: 204 No Content response. '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '409': description: The request conflicts with the current state of the resource. The operation cannot be completed. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Fax Media /Accounts/{AccountSid}/Faxes/{Sid}: get: operationId: retrieve_fax summary: Retrieve a Fax description: |- Retrieve a fax. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/FaxesAccountSidPath' - $ref: '#/components/parameters/FaxSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/FaxResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Faxes post: operationId: update_fax summary: Update a Fax description: |- Allows you to cancel a queued fax. Only faxes in 'queued' status can be canceled. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/FaxesAccountSidPath' - $ref: '#/components/parameters/FaxSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/FaxResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Faxes requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UpdateFaxRequest' delete: operationId: delete_fax summary: Delete a Fax description: |- Delete a fax. Cannot delete a fax that is currently in progress (processing, sending, or receiving). #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/FaxesAccountSidPath' - $ref: '#/components/parameters/FaxSidPath' responses: '204': description: 204 No Content response. '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '409': description: The request conflicts with the current state of the resource. The operation cannot be completed. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Faxes /Accounts/{AccountSid}/ImportedPhoneNumbers: post: operationId: create_imported_phone_number summary: Import a Phone Number description: |- Import a phone number you already own to your SignalWire Space to use with SignalWire APIs. **Note:** This is a **Partner API**. To enable it on your SignalWire Space, contact [Sales](https://signalwire.com/company/contact?utm_campaign=devex_sent_em). #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/ImportedPhoneNumbersAccountSidPath' responses: '201': description: The request has succeeded and a new resource has been created as a result. content: application/json: schema: $ref: '#/components/schemas/IncomingPhoneNumber' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The phone number import request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityImportedPhoneNumberError' tags: - Imported Phone Numbers requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/ImportPhoneNumberRequest' /Accounts/{AccountSid}/IncomingPhoneNumbers: get: operationId: list_incoming_phone_numbers summary: List all Incoming Phone Numbers description: |- List all incoming phone numbers. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/IncomingPhoneNumbersAccountSidPath' - name: Page in: query required: false description: The page index to retrieve. Zero-indexed. schema: type: integer format: int32 minimum: 0 default: 0 explode: false - name: PageSize in: query required: false description: The number of results per page. Default is 50, maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: Token for cursor-based pagination. Required when Page > 0. schema: type: string explode: false - name: PhoneNumber in: query required: false description: Only show numbers that match this pattern. schema: type: string explode: false - name: FriendlyName in: query required: false description: Only show numbers with this friendly name. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/IncomingPhoneNumberListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Incoming Phone Numbers post: operationId: create_incoming_phone_number summary: Create an Incoming Phone Number description: |- Purchase and provision a new incoming phone number. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/IncomingPhoneNumbersAccountSidPath' responses: '201': description: Response returned when an incoming phone number is created. content: application/json: schema: $ref: '#/components/schemas/IncomingPhoneNumber' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Incoming Phone Numbers requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/CreateIncomingPhoneNumberRequest' /Accounts/{AccountSid}/IncomingPhoneNumbers/{Sid}: get: operationId: retrieve_incoming_phone_number summary: Retrieve an incoming phone number description: |- Retrieve an incoming phone number. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/IncomingPhoneNumbersAccountSidPath' - $ref: '#/components/parameters/IncomingPhoneNumberSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/IncomingPhoneNumberResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Incoming Phone Numbers post: operationId: update_incoming_phone_number summary: Update an incoming phone number description: |- Update an incoming phone number. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/IncomingPhoneNumbersAccountSidPath' - $ref: '#/components/parameters/IncomingPhoneNumberSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/IncomingPhoneNumberResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Incoming Phone Numbers requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UpdateIncomingPhoneNumberRequest' delete: operationId: delete_incoming_phone_number summary: Delete an incoming phone number description: |- Release an incoming phone number. The number will be removed from your account. Note: Numbers cannot be released within a cooldown period after purchase. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/IncomingPhoneNumbersAccountSidPath' - $ref: '#/components/parameters/IncomingPhoneNumberSidPath' responses: '204': description: 204 No Content response. '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '409': description: The request conflicts with the current state of the resource. The operation cannot be completed. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Incoming Phone Numbers /Accounts/{AccountSid}/LamlBins: get: operationId: list_cxml_scripts summary: List All cXML Scripts description: |- Returns a list of your cXML scripts. The scripts are returned sorted by creation date, with the most recent appearing first. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_ or _Messaging_ or _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/CxmlScriptsAccountSidPath' - name: Name in: query required: false description: A friendly name given to the cXML script. schema: type: string explode: false - name: Page in: query required: false description: The page number to retrieve. Default is 0. schema: type: integer format: int32 default: 0 explode: false - name: PageSize in: query required: false description: The number of items per page. Default is 50, maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: The token for cursor-based pagination. Must start with 'PA' or 'PB'. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/CxmlScriptListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - CXML Scripts post: operationId: create_cxml_script summary: Create a cXML Script description: |- Create a cXML script. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_ or _Messaging_ or _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/CxmlScriptsAccountSidPath' responses: '201': description: Response returned when a cXML script is created. content: application/json: schema: $ref: '#/components/schemas/CxmlScript' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - CXML Scripts requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/CreateCxmlScriptRequest' /Accounts/{AccountSid}/LamlBins/{Sid}: get: operationId: retrieve_cxml_script summary: Retrieve a cXML Script description: |- Retrieve a cXML script. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_ or _Messaging_ or _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/CxmlScriptsAccountSidPath' - $ref: '#/components/parameters/CxmlScriptSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/CxmlScriptResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - CXML Scripts post: operationId: update_cxml_script summary: Update a cXML Script description: |- Update a cXML script. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_ or _Messaging_ or _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/CxmlScriptsAccountSidPath' - $ref: '#/components/parameters/CxmlScriptSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/CxmlScriptResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - CXML Scripts requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UpdateCxmlScriptRequest' delete: operationId: delete_cxml_script summary: Delete a cXML Script description: |- Delete a cXML script. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_ or _Messaging_ or _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/CxmlScriptsAccountSidPath' - $ref: '#/components/parameters/CxmlScriptSidPath' responses: '204': description: 204 No Content response. '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - CXML Scripts /Accounts/{AccountSid}/Messages: get: operationId: list_messages summary: List all Messages description: |- List all messages. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Messaging_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/MessagesAccountSidPath' - name: DateSent in: query required: false description: Only return messages sent on this particular date, formatted as YYYY-MM-DD in UTC. schema: type: string explode: false - name: DateSent< in: query required: false description: Only return messages sent before this date, formatted as YYYY-MM-DD in UTC. schema: type: string explode: false - name: DateSent> in: query required: false description: Only return messages sent after this date, formatted as YYYY-MM-DD in UTC. schema: type: string explode: false - name: From in: query required: false description: The phone number in E.164 format. For inbound messages, this will be the remote phone number who sent the message. For outbound messages, this will be one of your SignalWire phone numbers. schema: type: string explode: false - name: To in: query required: false description: The phone number in E.164 format that received the message. For inbound messages, this is one of your SignalWire phone numbers; for outbound messages, this is the remote phone number that received the message. schema: type: string explode: false - name: Status in: query required: false description: Current status of the message. schema: $ref: '#/components/schemas/MessageStatus' explode: false - name: Page in: query required: false description: The page number to retrieve. Default is 0. schema: type: integer format: int32 minimum: 0 default: 0 explode: false - name: PageSize in: query required: false description: The number of items per page. Default is 50, maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: The token for cursor-based pagination. Must start with 'PA' or 'PB'. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/MessageListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Messages post: operationId: create_message summary: Create a Message description: |- Create and send a message. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Messaging_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/MessagesAccountSidPath' responses: '201': description: Response returned when a message is created. content: application/json: schema: $ref: '#/components/schemas/Message' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Messages requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/CreateMessageRequest' /Accounts/{AccountSid}/Messages/{MessageSid}/Media: get: operationId: list_media summary: List Message Media description: |- List all media for a message. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Messaging_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/MessagesAccountSidPath' - $ref: '#/components/parameters/MessageSidPathForMedia' - name: DateCreated in: query required: false description: Only return media created on this particular date, formatted as YYYY-MM-DD in UTC. schema: type: string explode: false - name: DateCreated< in: query required: false description: Only return media created before this date, formatted as YYYY-MM-DD in UTC. schema: type: string explode: false - name: DateCreated> in: query required: false description: Only return media created after this date, formatted as YYYY-MM-DD in UTC. schema: type: string explode: false - name: Page in: query required: false description: The page number to retrieve. Default is 0. schema: type: integer format: int32 minimum: 0 default: 0 explode: false - name: PageSize in: query required: false description: The number of items per page. Default is 50, maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: The token for cursor-based pagination. Must start with 'PA' or 'PB'. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/MessageMediaListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Message Media /Accounts/{AccountSid}/Messages/{MessageSid}/Media/{Sid}: get: operationId: retrieve_media summary: Retrieve Message Media description: |- Retrieve media for a message. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Messaging_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/MessagesAccountSidPath' - $ref: '#/components/parameters/MessageSidPathForMedia' - $ref: '#/components/parameters/MessageSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/MessageMediaResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Message Media delete: operationId: delete_message_media summary: Delete Message Media description: |- Delete media for a message. Media cannot be deleted if the parent message is still in progress (initiated or queued status). #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Messaging_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/MessagesAccountSidPath' - $ref: '#/components/parameters/MessageSidPathForMedia' - $ref: '#/components/parameters/MessageSidPath' responses: '204': description: 204 No Content response. '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Message Media /Accounts/{AccountSid}/Messages/{Sid}: get: operationId: retrieve_message summary: Retrieve a Message description: |- Retrieve a single message. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Messaging_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/MessagesAccountSidPath' - $ref: '#/components/parameters/MessageSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/MessageResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Messages post: operationId: update_message summary: Update a Message description: |- Update a message body after it has been sent. Currently, the only supported update is redacting the message by setting the body to an empty string. Messages that are still in progress (queued or initiated status) cannot be updated. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Messaging_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/MessagesAccountSidPath' - $ref: '#/components/parameters/MessageSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/MessageResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Messages requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UpdateMessageRequest' delete: operationId: delete_message summary: Delete a Message description: |- Delete a message. Messages that are still in progress (queued status) cannot be deleted. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Messaging_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/MessagesAccountSidPath' - $ref: '#/components/parameters/MessageSidPath' responses: '204': description: 204 No Content response. '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Messages /Accounts/{AccountSid}/Queues: get: operationId: list_queues summary: List All Queues description: |- Retrieve all queues associated with your account. Results are returned as a paginated list. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/QueuesAccountSidPath' - name: Page in: query required: false description: The page number to retrieve (zero-indexed). schema: type: integer format: int32 minimum: 0 default: 0 explode: false - name: PageSize in: query required: false description: The number of results per page. Default is 50, maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: Token for cursor-based pagination. Required when navigating to pages beyond the first. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/QueueListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Queues post: operationId: create_queue summary: Create a Queue description: |- Create a call queue. Queue names must be unique among active queues within an account and can only contain alphanumeric characters and underscores. Deleted queue names can be reused. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/QueuesAccountSidPath' responses: '201': description: Response returned when a queue is successfully created. content: application/json: schema: $ref: '#/components/schemas/Queue' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Queues requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/CreateQueueRequest' /Accounts/{AccountSid}/Queues/{QueueSid}/Members: get: operationId: list_all_queue_members summary: List All Queue Members description: |- Retrieve all members currently waiting in a queue. Results are returned as a paginated list ordered by enqueue time. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/QueuesAccountSidPath' - $ref: '#/components/parameters/QueueSidPathForMembers' - name: Page in: query required: false description: The page number to retrieve (zero-indexed). schema: type: integer format: int32 minimum: 0 default: 0 explode: false - name: PageSize in: query required: false description: The number of results per page. Default is 50, maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: Token for cursor-based pagination. Required when navigating to pages beyond the first. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/QueueMemberListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Queue Members /Accounts/{AccountSid}/Queues/{QueueSid}/Members/{CallSid}: get: operationId: retrieve_queue_member summary: Retrieve a Queue Member description: |- Retrieve a single queue member by call SID. Use the special value `Front` to retrieve the member at the front of the queue. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/QueuesAccountSidPath' - $ref: '#/components/parameters/QueueSidPathForMembers' - $ref: '#/components/parameters/QueueMemberCallSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/QueueMemberResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Queue Members post: operationId: update_queue_member summary: Update a Queue Member description: |- Dequeue a member from a queue and redirect them to a new URL. Use the special value `Front` for the CallSid to dequeue the member at the front of the queue. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/QueuesAccountSidPath' - $ref: '#/components/parameters/QueueSidPathForMembers' - $ref: '#/components/parameters/QueueMemberCallSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/QueueMemberResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '503': description: The service is temporarily unavailable. Please try again later. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Queue Members requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UpdateQueueMemberRequest' /Accounts/{AccountSid}/Queues/{Sid}: get: operationId: retrieve_queue summary: Retrieve a Queue description: |- Retrieve a single queue by its unique identifier. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/QueuesAccountSidPath' - $ref: '#/components/parameters/QueueSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/QueueResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Queues post: operationId: update_queue summary: Update a Queue description: |- Modify the properties of a call queue. Queue names must be unique among active queues within an account. Deleted queue names can be reused. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/QueuesAccountSidPath' - $ref: '#/components/parameters/QueueSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/QueueResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Queues requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UpdateQueueRequest' delete: operationId: delete_queue summary: Delete a Queue description: |- Delete a call queue. Only empty queues can be deleted - attempting to delete a queue with members will return a 422 error. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/QueuesAccountSidPath' - $ref: '#/components/parameters/QueueSidPath' responses: '204': description: 204 No Content response. '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Queues /Accounts/{AccountSid}/Recordings: get: operationId: list_recordings summary: List all Recordings description: |- List all recordings. Results are returned as a paginated list ordered by creation date (newest first). #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/RecordingsAccountSidPath' - name: DateCreated in: query required: false description: Filter by recordings created on this exact date (RFC 2822 format). schema: type: string explode: false - name: DateCreated< in: query required: false description: Filter by recordings created before this date (RFC 2822 format). schema: type: string explode: false - name: DateCreated> in: query required: false description: Filter by recordings created after this date (RFC 2822 format). schema: type: string explode: false - name: CallSid in: query required: false description: Filter by recordings associated with a specific call. schema: $ref: '#/components/schemas/uuid' explode: false - name: ConferenceSid in: query required: false description: Filter by recordings associated with a specific conference. schema: $ref: '#/components/schemas/uuid' explode: false - name: Page in: query required: false description: The page number to retrieve (zero-indexed). schema: type: integer format: int32 minimum: 0 default: 0 explode: false - name: PageSize in: query required: false description: The number of results per page. Default is 50, maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: Token for cursor-based pagination. Required when navigating to pages beyond the first. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/RecordingListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Recordings /Accounts/{AccountSid}/Recordings/{Sid}: get: operationId: retrieve_recording summary: Retrieve a Recording description: |- Retrieve a single recording media or its metadata. This endpoint supports two different access methods with different authentication requirements: ## Public Access (No Authentication Required) Recording audio files can be accessed directly without authentication. This is useful for external applications to embed recording URLs without exposing SignalWire API credentials. SignalWire recording URLs are long and random, making them difficult to guess or exploit unless you reveal the URL. **Retrieve WAV file** When a recording URI has no extension or a `.wav` extension, the request will return a binary WAV version of the recording file. `GET https://example.signalwire.com/api/laml/2010-04-01/Accounts/{AccountSid}/Recordings/{Sid}` `GET https://example.signalwire.com/api/laml/2010-04-01/Accounts/{AccountSid}/Recordings/{Sid}.wav` **Retrieve MP3 file** Setting an extension of ".mp3" on the URI returns a binary MP3 version of the recording. For example: `GET https://example.signalwire.com/api/laml/2010-04-01/Accounts/{AccountSid}/Recordings/{Sid}.mp3` ## Authenticated Access (Voice Scope Required) **Retrieve Metadata** A recording's metadata, such as duration, cost, time, can be returned by setting the Recording URI's extension to `.json`. This requires authentication with a Voice-scoped API token. `GET https://example.signalwire.com/api/laml/2010-04-01/Accounts/{AccountSid}/Recordings/{Sid}.json` #### Permissions The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_. This permission is only required for authenticated requests to retrieve recording metadata (.json extension). [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/RecordingsAccountSidPath' - $ref: '#/components/parameters/RecordingSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/RecordingResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Recordings delete: operationId: delete_recording summary: Delete a Recording. description: |- Delete recording. If the delete is successful, a 204 response, with no body, will be returned. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/RecordingsAccountSidPath' - $ref: '#/components/parameters/RecordingSidPath' responses: '204': description: 204 No Content response. '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Recordings /Accounts/{AccountSid}/Transcriptions: get: operationId: list_transcriptions summary: List all Transcriptions description: |- List all transcriptions. Results are returned as a paginated list ordered by creation date (newest first). #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/TranscriptionsAccountSidPath' - name: DateCreated in: query required: false description: Filter by transcriptions created on this exact date (RFC 2822 format). schema: type: string explode: false - name: DateCreated< in: query required: false description: Filter by transcriptions created before this date (RFC 2822 format). schema: type: string explode: false - name: DateCreated> in: query required: false description: Filter by transcriptions created after this date (RFC 2822 format). schema: type: string explode: false - name: Page in: query required: false description: The page number to retrieve (zero-indexed). schema: type: integer format: int32 minimum: 0 default: 0 explode: false - name: PageSize in: query required: false description: The number of results per page. Default is 50, maximum is 1000. schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 50 explode: false - name: PageToken in: query required: false description: Token for cursor-based pagination. Required when navigating to pages beyond the first. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/TranscriptionListResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Recording Transcriptions /Accounts/{AccountSid}/Transcriptions/{Sid}: get: operationId: retrieve_transcription summary: Retrieve a Transcription description: |- Retrieve a single recording transcription. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/TranscriptionsAccountSidPath' - $ref: '#/components/parameters/TranscriptionSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/TranscriptionResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Recording Transcriptions delete: operationId: delete_transcription summary: Delete a Recording Transcription description: |- Delete a recording transcription from your account. If the delete is successful, a 204 response, with no body, will be returned. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/TranscriptionsAccountSidPath' - $ref: '#/components/parameters/TranscriptionSidPath' responses: '204': description: 204 No Content response. '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Recording Transcriptions /Accounts/{AccountSid}/tokens: post: operationId: create_token summary: Generate a new API Token description: |- Generate an API Token for a project to be used to authenticate requests within the project. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Management_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/TokensAccountSidPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/TokenResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The token request could not be processed due to validation errors. Check the error details for the specific issue. content: application/json: schema: $ref: '#/components/schemas/CompatibilityTokenValidationError' tags: - Tokens requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/CreateTokenRequest' /Accounts/{AccountSid}/tokens/{token_id}: patch: operationId: update_token summary: Update an API Token description: |- Update an API Token's name or permissions. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Management_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/TokensAccountSidPath' - $ref: '#/components/parameters/TokenIdPath' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/TokenResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The token request could not be processed due to validation errors. Check the error details for the specific issue. content: application/json: schema: $ref: '#/components/schemas/CompatibilityTokenValidationError' tags: - Tokens requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateTokenRequest' delete: operationId: delete_token summary: Delete an API Token description: |- Delete an API Token. This action cannot be undone. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Management_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/TokensAccountSidPath' - $ref: '#/components/parameters/TokenIdPath' responses: '204': description: 204 No Content response. '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Tokens /Accounts/{Sid}: get: operationId: get_account summary: Find an Account by ID description: |- Find a Project (also referred to as _Account_) by ID. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Management_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/AccountPathSid' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/AccountResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Accounts post: operationId: update_account summary: Update an Account description: |- Update a Project (also referred to as _Account_). #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Management_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). parameters: - $ref: '#/components/parameters/AccountPathSid' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/AccountResponse' '400': description: The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' tags: - Accounts requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UpdateAccountRequest' security: - SignalWireBasicAuth: [] components: parameters: AccountPathSid: name: Sid in: path required: true description: The Project ID that uniquely identifies the Project to retrieve. schema: $ref: '#/components/schemas/uuid' AccountSidPath: name: AccountSid in: path required: true description: The Account ID that has the Application. schema: $ref: '#/components/schemas/uuid' ApplicationPathSid: name: Sid in: path required: true description: The Application ID that uniquely identifies the Application. schema: $ref: '#/components/schemas/uuid' AvailablePhoneNumbersAccountSidPath: name: AccountSid in: path required: true description: The Project ID that uniquely identifies the Account to retrieve. schema: $ref: '#/components/schemas/uuid' CallSidPath: name: Sid in: path required: true description: The unique identifier for the call. schema: $ref: '#/components/schemas/uuid' CallSidPathForRecording: name: CallSid in: path required: true description: The unique identifier for the call. schema: $ref: '#/components/schemas/uuid' CallsAccountSidPath: name: AccountSid in: path required: true description: The Project ID that uniquely identifies the Account. schema: $ref: '#/components/schemas/uuid' ConferenceRecordingSidPath: name: Sid in: path required: true description: The unique identifier for the recording. schema: $ref: '#/components/schemas/uuid' ConferenceSidPath: name: Sid in: path required: true description: The unique identifier for this conference. schema: $ref: '#/components/schemas/uuid' ConferenceSidPathForParticipant: name: ConferenceSid in: path required: true description: The unique identifier for the conference this participant is in. schema: $ref: '#/components/schemas/uuid' ConferenceStreamSidPath: name: Sid in: path required: true description: The unique identifier for the stream. schema: $ref: '#/components/schemas/uuid' ConferencesAccountSidPath: name: AccountSid in: path required: true description: The unique identifier for the account that created this conference. schema: $ref: '#/components/schemas/uuid' CxmlScriptSidPath: name: Sid in: path required: true description: The unique identifier of the cXML script. schema: $ref: '#/components/schemas/uuid' CxmlScriptsAccountSidPath: name: AccountSid in: path required: true description: The unique identifier for the account this script is associated with. schema: $ref: '#/components/schemas/uuid' FaxSidPath: name: Sid in: path required: true description: The Fax ID that uniquely identifies the Fax. schema: $ref: '#/components/schemas/uuid' FaxSidPathForMedia: name: FaxSid in: path required: true description: The Fax ID that uniquely identifies the Fax. schema: $ref: '#/components/schemas/uuid' FaxesAccountSidPath: name: AccountSid in: path required: true description: The Project ID that uniquely identifies the Account. schema: $ref: '#/components/schemas/uuid' ImportedPhoneNumbersAccountSidPath: name: AccountSid in: path required: true description: The unique identifier for the account that is associated with this phone number. schema: $ref: '#/components/schemas/uuid' IncomingPhoneNumberSidPath: name: Sid in: path required: true description: The unique identifier of the phone number. schema: $ref: '#/components/schemas/uuid' IncomingPhoneNumbersAccountSidPath: name: AccountSid in: path required: true description: The unique identifier for the account that is associated with this phone number. schema: $ref: '#/components/schemas/uuid' IsoCountryPath: name: IsoCountry in: path required: true description: The ISO country code of the number. schema: type: string MessageSidPath: name: Sid in: path required: true description: A unique ID that identifies this specific message. schema: $ref: '#/components/schemas/uuid' MessageSidPathForMedia: name: MessageSid in: path required: true description: A unique ID that identifies this specific message. schema: $ref: '#/components/schemas/uuid' MessagesAccountSidPath: name: AccountSid in: path required: true description: The unique identifier of the project that sent or received this message. schema: $ref: '#/components/schemas/uuid' ParticipantCallSidPath: name: CallSid in: path required: true description: The unique identifier for the Participant call connected to this conference. schema: $ref: '#/components/schemas/uuid' QueueMemberCallSidPath: name: CallSid in: path required: true description: The unique identifier for the call, or the special value 'Front' to reference the member at the front of the queue. schema: type: string QueueSidPath: name: Sid in: path required: true description: The unique identifier for the queue. schema: $ref: '#/components/schemas/uuid' QueueSidPathForMembers: name: QueueSid in: path required: true description: The unique identifier for the queue. schema: $ref: '#/components/schemas/uuid' QueuesAccountSidPath: name: AccountSid in: path required: true description: The unique identifier for the account this Queue is associated with. schema: $ref: '#/components/schemas/uuid' RecordingSidPath: name: Sid in: path required: true description: The unique identifier for the recording. schema: $ref: '#/components/schemas/uuid' RecordingsAccountSidPath: name: AccountSid in: path required: true description: The unique identifier for the account that is associated with this recording. schema: $ref: '#/components/schemas/uuid' TokenIdPath: name: token_id in: path required: true description: The unique identifier of the project API token. schema: $ref: '#/components/schemas/uuid' TokensAccountSidPath: name: AccountSid in: path required: true description: The unique identifier for the project you want to use to authenticate this request. schema: $ref: '#/components/schemas/uuid' TranscriptionSidPath: name: Sid in: path required: true description: The unique identifier for the transcription. schema: $ref: '#/components/schemas/uuid' TranscriptionsAccountSidPath: name: AccountSid in: path required: true description: The unique identifier for the account that created this transcription. schema: $ref: '#/components/schemas/uuid' schemas: Account: type: object required: - sid - friendly_name - status - auth_token - date_created - date_updated - type - owner_account_sid - region_preference - uri - subproject - signing_key - subresource_uris properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for this Project. examples: - b3877c40-da60-4998-90ad-b792e98472af friendly_name: type: string description: The name of the Project. examples: - My Project status: allOf: - $ref: '#/components/schemas/AccountStatus' description: The status of the Project. Always 'active'. auth_token: type: string description: The authorization token for this Project. Always returns 'redacted' for security. examples: - redacted date_created: type: string description: The date and time this Project was created, in RFC 2822 format. examples: - Sat, 15 Sep 2018 10:00:00 +0000 date_updated: type: string description: The date and time this Project was last updated, in RFC 2822 format. examples: - Sat, 16 Sep 2018 10:00:00 +0000 type: allOf: - $ref: '#/components/schemas/AccountType' description: The type of the Project. Always 'Full'. owner_account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The Project ID of the parent project. For parent projects, this is the same as sid. examples: - b3877c40-da60-4998-90ad-b792e98472af region_preference: type: string description: The preferred region for the Project. examples: - us-east uri: type: string description: The URI for the Project. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af subproject: type: boolean description: Whether this project is a sub-project of another project. examples: - false signing_key: anyOf: - type: string - type: 'null' description: The signing key for the Project. Only returned once when a subproject is created. Subsequent requests return null. examples: - null subresource_uris: allOf: - $ref: '#/components/schemas/SubresourceUris' description: A map of URIs for sub-resources linked to this Project. unevaluatedProperties: not: {} description: Account/Project model representing a SignalWire project. AccountListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - accounts properties: uri: type: string description: The URI of the current page. examples: - /api/laml/2010-04-01/Accounts?Page=0&PageSize=50 first_page_uri: type: string description: The URI of the first page. examples: - /api/laml/2010-04-01/Accounts?Page=0&PageSize=50 next_page_uri: anyOf: - type: string - type: 'null' description: The URI of the next page. Null if there are no more results. examples: - /api/laml/2010-04-01/Accounts?Page=1&PageSize=50 previous_page_uri: anyOf: - type: string - type: 'null' description: The URI of the previous page. Null if this is the first page. examples: - null page: type: integer format: int32 description: The current page number (zero-indexed). examples: - 0 page_size: type: integer format: int32 description: The number of results per page. examples: - 50 accounts: type: array items: $ref: '#/components/schemas/Account' description: List of accounts. unevaluatedProperties: not: {} description: Response containing a list of accounts. AccountResponse: type: object required: - sid - friendly_name - status - auth_token - date_created - date_updated - type - owner_account_sid - region_preference - uri - subproject - signing_key - subresource_uris properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for this Project. examples: - b3877c40-da60-4998-90ad-b792e98472af friendly_name: type: string description: The name of the Project. examples: - My Project status: allOf: - $ref: '#/components/schemas/AccountStatus' description: The status of the Project. Always 'active'. auth_token: type: string description: The authorization token for this Project. Always returns 'redacted' for security. examples: - redacted date_created: type: string description: The date and time this Project was created, in RFC 2822 format. examples: - Sat, 15 Sep 2018 10:00:00 +0000 date_updated: type: string description: The date and time this Project was last updated, in RFC 2822 format. examples: - Sat, 16 Sep 2018 10:00:00 +0000 type: allOf: - $ref: '#/components/schemas/AccountType' description: The type of the Project. Always 'Full'. owner_account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The Project ID of the parent project. For parent projects, this is the same as sid. examples: - b3877c40-da60-4998-90ad-b792e98472af region_preference: type: string description: The preferred region for the Project. examples: - us-east uri: type: string description: The URI for the Project. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af subproject: type: boolean description: Whether this project is a sub-project of another project. examples: - false signing_key: anyOf: - type: string - type: 'null' description: The signing key for the Project. Only returned once when a subproject is created. Subsequent requests return null. examples: - null subresource_uris: allOf: - $ref: '#/components/schemas/SubresourceUris' description: A map of URIs for sub-resources linked to this Project. unevaluatedProperties: not: {} description: Response containing a single account. AccountStatus: type: string enum: - active description: The status of the Project. AccountType: type: string enum: - Full description: The type of the Project. AddressRequirements: type: string enum: - none - any - local - foreign description: Address requirements. AnsweredBy: type: string enum: - human - machine description: Who/what answered the call. Application: type: object required: - sid - account_sid - api_version - date_created - date_updated - friendly_name - uri - voice_url - voice_method - voice_fallback_url - voice_fallback_method - status_callback - status_callback_method - voice_caller_id_lookup - sms_url - sms_method - sms_fallback_url - sms_fallback_method - sms_status_callback - sms_status_callback_method - message_status_callback properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the Application. examples: - b3877c40-da60-4998-90ad-b792e98472af account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the Account that created this Application. examples: - b3877c40-da60-4998-90ad-b792e98472af api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' date_created: type: string description: The date, in RFC 2822 GMT format, this Application was created. examples: - Sat, 15 Sept 2018 10:00:00 +0000 date_updated: type: string description: The date, in RFC 2822 GMT format, this Application was updated. examples: - Sat, 16 Sept 2018 10:00:00 +0000 friendly_name: type: string description: A named unique identifier for the resource. examples: - My Friendly Name uri: type: string description: The URI for this Application. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Applications/b3877c40-da60-4998-90ad-b792e98472af.json voice_url: anyOf: - type: string - type: 'null' description: The URL to request when a phone number receives a call or fax. examples: - http://example.com voice_method: anyOf: - type: string - type: 'null' description: Whether the request to `VoiceUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST voice_fallback_url: anyOf: - type: string - type: 'null' description: The URL SignalWire will request if errors occur when fetching the `VoiceUrl`. examples: - http://example.com voice_fallback_method: anyOf: - type: string - type: 'null' description: Whether the request to `VoiceFallbackUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST status_callback: anyOf: - type: string - type: 'null' description: The URL to pass status updates to the Application. examples: - http://example.com status_callback_method: anyOf: - type: string - type: 'null' description: Whether the request to the `StatusCallback` URL is a `GET` or a `POST`. Default is `POST`. examples: - POST voice_caller_id_lookup: anyOf: - type: boolean - type: 'null' description: Whether or not to look up a caller's ID from the database. Always null. examples: - null sms_url: anyOf: - type: string - type: 'null' description: The URL to request when an SMS is received. examples: - http://example.com sms_method: anyOf: - type: string - type: 'null' description: Whether the request to `SmsUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST sms_fallback_url: anyOf: - type: string - type: 'null' description: The URL SignalWire will request if errors occur when fetching the `SmsUrl`. examples: - http://www.example.com/sms-fallback sms_fallback_method: anyOf: - type: string - type: 'null' description: Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST sms_status_callback: anyOf: - type: string - type: 'null' description: The URL to receive status updates for messages sent via this Application. examples: - http://www.example.com/sms-status-callback sms_status_callback_method: anyOf: - type: string - type: 'null' description: Whether the request to `SmsStatusCallback` is a `GET` or a `POST`. Default is `POST`. examples: - POST message_status_callback: anyOf: - type: string - type: 'null' description: The URL to receive status updates for messages sent via this Application. examples: - http://www.example.com/sms-status-callback unevaluatedProperties: not: {} description: Application model representing a cXML application. ApplicationListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - applications properties: uri: type: string description: The URI for this resource. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Applications?Page=0&PageSize=50 first_page_uri: type: string description: The URI for the first page of results. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Applications?Page=0&PageSize=50 next_page_uri: anyOf: - type: string - type: 'null' description: The URI for the next page of results. Null if there are no more pages. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Applications?Page=1&PageSize=50 previous_page_uri: anyOf: - type: string - type: 'null' description: The URI for the previous page of results. Null if this is the first page. examples: - null page: type: integer format: int32 description: The current page number. Zero-indexed. examples: - 0 page_size: type: integer format: int32 description: The number of results per page. examples: - 50 applications: type: array items: $ref: '#/components/schemas/Application' description: List of applications. unevaluatedProperties: not: {} description: Response containing a list of applications. ApplicationResponse: type: object required: - sid - account_sid - api_version - date_created - date_updated - friendly_name - uri - voice_url - voice_method - voice_fallback_url - voice_fallback_method - status_callback - status_callback_method - voice_caller_id_lookup - sms_url - sms_method - sms_fallback_url - sms_fallback_method - sms_status_callback - sms_status_callback_method - message_status_callback properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the Application. examples: - b3877c40-da60-4998-90ad-b792e98472af account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the Account that created this Application. examples: - b3877c40-da60-4998-90ad-b792e98472af api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' date_created: type: string description: The date, in RFC 2822 GMT format, this Application was created. examples: - Sat, 15 Sept 2018 10:00:00 +0000 date_updated: type: string description: The date, in RFC 2822 GMT format, this Application was updated. examples: - Sat, 16 Sept 2018 10:00:00 +0000 friendly_name: type: string description: A named unique identifier for the resource. examples: - My Friendly Name uri: type: string description: The URI for this Application. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Applications/b3877c40-da60-4998-90ad-b792e98472af.json voice_url: anyOf: - type: string - type: 'null' description: The URL to request when a phone number receives a call or fax. examples: - http://example.com voice_method: anyOf: - type: string - type: 'null' description: Whether the request to `VoiceUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST voice_fallback_url: anyOf: - type: string - type: 'null' description: The URL SignalWire will request if errors occur when fetching the `VoiceUrl`. examples: - http://example.com voice_fallback_method: anyOf: - type: string - type: 'null' description: Whether the request to `VoiceFallbackUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST status_callback: anyOf: - type: string - type: 'null' description: The URL to pass status updates to the Application. examples: - http://example.com status_callback_method: anyOf: - type: string - type: 'null' description: Whether the request to the `StatusCallback` URL is a `GET` or a `POST`. Default is `POST`. examples: - POST voice_caller_id_lookup: anyOf: - type: boolean - type: 'null' description: Whether or not to look up a caller's ID from the database. Always null. examples: - null sms_url: anyOf: - type: string - type: 'null' description: The URL to request when an SMS is received. examples: - http://example.com sms_method: anyOf: - type: string - type: 'null' description: Whether the request to `SmsUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST sms_fallback_url: anyOf: - type: string - type: 'null' description: The URL SignalWire will request if errors occur when fetching the `SmsUrl`. examples: - http://www.example.com/sms-fallback sms_fallback_method: anyOf: - type: string - type: 'null' description: Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST sms_status_callback: anyOf: - type: string - type: 'null' description: The URL to receive status updates for messages sent via this Application. examples: - http://www.example.com/sms-status-callback sms_status_callback_method: anyOf: - type: string - type: 'null' description: Whether the request to `SmsStatusCallback` is a `GET` or a `POST`. Default is `POST`. examples: - POST message_status_callback: anyOf: - type: string - type: 'null' description: The URL to receive status updates for messages sent via this Application. examples: - http://www.example.com/sms-status-callback unevaluatedProperties: not: {} description: Response containing a single application. AvailablePhoneNumber: type: object required: - friendly_name - phone_number - lata - locality - rate_center - latitude - longitude - region - postal_code - iso_country - capabilities - beta properties: friendly_name: type: string description: A formatted version of the number. examples: - (253) 218-6751 phone_number: type: string description: The number in E.164 format. examples: - '+12532186751' lata: anyOf: - type: string - type: 'null' description: The LATA of the number. Always null. examples: - null locality: anyOf: - type: string - type: 'null' description: The locality/city of the number. Always null. examples: - null rate_center: anyOf: - type: string - type: 'null' description: The rate center of the number. Only available for numbers in US and Canada. examples: - AUBURN latitude: anyOf: - type: string - type: 'null' description: The latitude of the number. Always null. examples: - null longitude: anyOf: - type: string - type: 'null' description: The longitude of the number. Always null. examples: - null region: anyOf: - type: string - type: 'null' description: The state or province abbreviation of the number. Only available for numbers in US and Canada. examples: - WA postal_code: anyOf: - type: string - type: 'null' description: The postal/zip code of the number. Always null. examples: - null iso_country: type: string description: The ISO country code of the number. examples: - US capabilities: allOf: - $ref: '#/components/schemas/PhoneNumberCapabilities' description: Whether or not a number can receive calls and messages. beta: type: boolean description: Always `false`. Included for Twilio API compatibility. examples: - false unevaluatedProperties: not: {} description: Available phone number model. AvailablePhoneNumberByCountryResponse: type: object required: - country_code - country - uri - beta - subresource_uris properties: country_code: type: string description: The ISO country code of the number. examples: - US country: type: string description: The country the number is from. examples: - United States uri: type: string description: The URI for the API call. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/AvailablePhoneNumbers/US beta: type: boolean description: New numbers on SignalWire are marked as `beta`. examples: - false subresource_uris: allOf: - $ref: '#/components/schemas/CountrySubresourceUris' description: URIs for subresources. unevaluatedProperties: not: {} description: Response containing available phone number resources for a specific country. AvailablePhoneNumberListResponse: type: object required: - uri - available_phone_numbers properties: uri: type: string description: The URI for the API call. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/AvailablePhoneNumbers/US/Local available_phone_numbers: type: array items: $ref: '#/components/schemas/AvailablePhoneNumber' description: List of available phone numbers. unevaluatedProperties: not: {} description: Response containing a list of available phone numbers. AvailablePhoneNumberResourcesResponse: type: object required: - uri - countries properties: uri: type: string description: The URI for the API call. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/AvailablePhoneNumbers countries: type: array items: $ref: '#/components/schemas/CountryResource' description: List of available countries. unevaluatedProperties: not: {} description: Response containing a list of available phone number resources (countries). Call: type: object required: - sid - account_sid - date_created - date_updated - parent_call_sid - to - formatted_to - to_formatted - from - formatted_from - from_formatted - phone_number_sid - status - start_time - end_time - duration - price - price_unit - direction - answered_by - api_version - forwarded_from - caller_name - uri - subresource_uris - annotation - group_sid - audio_in_mos - sip_result_code - audio_rtt_avg - audio_rtt_min - audio_rtt_max - audio_out_jitter_min - audio_out_jitter_max - audio_out_jitter_avg - audio_out_lost properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the call. examples: - b3877c40-da60-4998-90ad-b792e98472ca account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that created this call. examples: - b3877c40-da60-4998-90ad-b792e98472af date_created: type: string description: The date, in RFC 2822 GMT format, this call was created. examples: - Wed, 19 Sep 2018 20:00:00 +0000 date_updated: type: string description: The date, in RFC 2822 GMT format, this call was updated. examples: - Wed, 19 Sep 2018 21:00:00 +0000 parent_call_sid: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier for the call that created this call. examples: - b3877c40-da60-4998-90ad-b792e98472af to: type: string description: The address that received the call. examples: - '+13105678901' formatted_to: type: string description: The formatted number that received the call. examples: - (310) 567-8901 to_formatted: type: string description: The formatted number that received the call. Alias for formatted_to. examples: - (310) 567-8901 from: type: string description: The address that initiated the call. examples: - '+13103384645' formatted_from: type: string description: The formatted number that initiated the call. examples: - (310) 338-4645 from_formatted: type: string description: The formatted number that initiated the call. Alias for formatted_from. examples: - (310) 338-4645 phone_number_sid: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier for the phone number. examples: - b3877c40-da60-4998-90ad-b792e98472pn status: allOf: - $ref: '#/components/schemas/CallStatus' description: The status of the call. start_time: anyOf: - type: string - type: 'null' description: The time, in RFC 2822 GMT format, on which the call began. examples: - Wed, 19 Sep 2018 20:00:01 +0000 end_time: anyOf: - type: string - type: 'null' description: The time, in RFC 2822 GMT format, on which the call was terminated. examples: - Fri, 21 Sep 2018 10:00:00 +0000 duration: type: integer format: int32 description: The duration, in seconds, of the call. examples: - 20 price: anyOf: - type: number format: float - type: 'null' description: The charge for the call. examples: - 0.003 price_unit: type: string description: The currency, in ISO 4127 format, for the price of the call. examples: - USD direction: allOf: - $ref: '#/components/schemas/CallDirection' description: The direction of the call. answered_by: anyOf: - $ref: '#/components/schemas/AnsweredBy' - type: 'null' description: Who/what the call was answered by. api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' forwarded_from: anyOf: - type: string - type: 'null' description: The number this call was forwarded from. Always null. examples: - null caller_name: anyOf: - type: string - type: 'null' description: The caller name. Always null. examples: - null uri: type: string description: The URI for the call. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472ca.json subresource_uris: allOf: - $ref: '#/components/schemas/CallSubresourceUris' description: A Map of available sub-resources. annotation: anyOf: - type: string - type: 'null' description: The annotation for the call. Always null. examples: - null group_sid: anyOf: - type: string - type: 'null' description: The group SID for the call. Always null. examples: - null audio_in_mos: anyOf: - type: number format: float - type: 'null' description: The Mean Opinion Score for audio quality (1.0-5.0). examples: - 4.5 sip_result_code: anyOf: - type: string - type: 'null' description: The SIP result code for the call. examples: - '200' audio_rtt_avg: anyOf: - type: integer format: int32 - type: 'null' description: The average round-trip time for audio in milliseconds. examples: - 50 audio_rtt_min: anyOf: - type: integer format: int32 - type: 'null' description: The minimum round-trip time for audio in milliseconds. examples: - 20 audio_rtt_max: anyOf: - type: integer format: int32 - type: 'null' description: The maximum round-trip time for audio in milliseconds. examples: - 100 audio_out_jitter_min: anyOf: - type: integer format: int32 - type: 'null' description: The minimum outbound audio jitter in milliseconds. examples: - 1 audio_out_jitter_max: anyOf: - type: integer format: int32 - type: 'null' description: The maximum outbound audio jitter in milliseconds. examples: - 10 audio_out_jitter_avg: anyOf: - type: integer format: int32 - type: 'null' description: The average outbound audio jitter in milliseconds. examples: - 5 audio_out_lost: anyOf: - type: integer format: int32 - type: 'null' description: The number of outbound audio packets lost. examples: - 0 unevaluatedProperties: not: {} description: Call model representing a voice call. CallDirection: type: string enum: - inbound - outbound description: Call direction. CallListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - calls properties: uri: type: string description: The URI of the current page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls?Page=0&PageSize=50 first_page_uri: type: string description: The URI of the first page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls?Page=0&PageSize=50 next_page_uri: anyOf: - type: string - type: 'null' description: The URI of the next page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls?Page=1&PageSize=50&PageToken=PAxxxxxxxxxx previous_page_uri: anyOf: - type: string - type: 'null' description: The URI of the previous page. examples: - null page: type: integer format: int32 description: The current page number. examples: - 0 page_size: type: integer format: int32 description: The number of items per page. examples: - 50 calls: type: array items: $ref: '#/components/schemas/Call' description: List of calls. unevaluatedProperties: not: {} description: Response containing a list of calls. CallRecordingResponse: type: object required: - sid - account_sid - api_version - call_sid - conference_sid - channel - channels - date_created - date_updated - start_time - end_time - duration - price - price_unit - source - status - error_code - uri - subresource_uris - encryption_details - trim properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the recording. examples: - 19e436af-5688-4307-b03b-bdb2b42b8142 account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that is associated with this recording. examples: - 720796a0-8ee9-4350-83bd-2d07a3121f1e api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' call_sid: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier for the call that is associated with this recording. Null if this is a conference recording. examples: - 43bb71ee-553f-4074-bb20-8e2747647cce conference_sid: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier for the conference that is associated with this recording. Null if this is a call recording. examples: - null channel: type: string enum: - '1' - '2' description: The number of channels in a recording (singular key). Returns '1' for mono or '2' for stereo. examples: - '1' channels: type: string enum: - '1' - '2' description: The number of channels in a recording. Returns '1' for mono or '2' for stereo. examples: - '1' date_created: type: string description: The date, in RFC 2822 format, this recording was created. examples: - Tue, 25 Sep 2018 23:00:00 +0000 date_updated: type: string description: The date, in RFC 2822 format, this recording was updated. examples: - Wed, 26 Sep 2018 23:00:04 +0000 start_time: anyOf: - type: string - type: 'null' description: The time, in RFC 2822 format, this recording started. examples: - Tue, 25 Sep 2018 23:00:00 +0000 end_time: anyOf: - type: string - type: 'null' description: The time, in RFC 2822 format, this recording ended. examples: - Wed, 26 Sep 2018 23:00:04 +0000 duration: type: integer format: int32 description: The length, in seconds, of the recording. examples: - 4 price: anyOf: - type: string - type: 'null' description: The cost for the recording. examples: - '-0.0025' price_unit: type: string description: The currency of the price of the recording. examples: - USD source: allOf: - $ref: '#/components/schemas/RecordingSource' description: How the recording was made. status: allOf: - $ref: '#/components/schemas/RecordingStatus' description: The status of the recording. error_code: anyOf: - type: string - type: 'null' description: Further details about a failed recording. examples: - null uri: type: string description: The URI of the recording. examples: - /api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Recordings/19e436af-5688-4307-b03b-bdb2b42b8142.json subresource_uris: allOf: - $ref: '#/components/schemas/RecordingSubresourceUris' description: Subresource URIs. encryption_details: anyOf: - type: string - type: 'null' description: Encryption details. Always null. examples: - null trim: type: string description: Whether leading and trailing silence is trimmed from a recording. examples: - do-not-trim unevaluatedProperties: not: {} description: Response containing a single call recording. CallResponse: type: object required: - sid - account_sid - date_created - date_updated - parent_call_sid - to - formatted_to - to_formatted - from - formatted_from - from_formatted - phone_number_sid - status - start_time - end_time - duration - price - price_unit - direction - answered_by - api_version - forwarded_from - caller_name - uri - subresource_uris - annotation - group_sid - audio_in_mos - sip_result_code - audio_rtt_avg - audio_rtt_min - audio_rtt_max - audio_out_jitter_min - audio_out_jitter_max - audio_out_jitter_avg - audio_out_lost properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the call. examples: - b3877c40-da60-4998-90ad-b792e98472ca account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that created this call. examples: - b3877c40-da60-4998-90ad-b792e98472af date_created: type: string description: The date, in RFC 2822 GMT format, this call was created. examples: - Wed, 19 Sep 2018 20:00:00 +0000 date_updated: type: string description: The date, in RFC 2822 GMT format, this call was updated. examples: - Wed, 19 Sep 2018 21:00:00 +0000 parent_call_sid: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier for the call that created this call. examples: - b3877c40-da60-4998-90ad-b792e98472af to: type: string description: The address that received the call. examples: - '+13105678901' formatted_to: type: string description: The formatted number that received the call. examples: - (310) 567-8901 to_formatted: type: string description: The formatted number that received the call. Alias for formatted_to. examples: - (310) 567-8901 from: type: string description: The address that initiated the call. examples: - '+13103384645' formatted_from: type: string description: The formatted number that initiated the call. examples: - (310) 338-4645 from_formatted: type: string description: The formatted number that initiated the call. Alias for formatted_from. examples: - (310) 338-4645 phone_number_sid: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier for the phone number. examples: - b3877c40-da60-4998-90ad-b792e98472pn status: allOf: - $ref: '#/components/schemas/CallStatus' description: The status of the call. start_time: anyOf: - type: string - type: 'null' description: The time, in RFC 2822 GMT format, on which the call began. examples: - Wed, 19 Sep 2018 20:00:01 +0000 end_time: anyOf: - type: string - type: 'null' description: The time, in RFC 2822 GMT format, on which the call was terminated. examples: - Fri, 21 Sep 2018 10:00:00 +0000 duration: type: integer format: int32 description: The duration, in seconds, of the call. examples: - 20 price: anyOf: - type: number format: float - type: 'null' description: The charge for the call. examples: - 0.003 price_unit: type: string description: The currency, in ISO 4127 format, for the price of the call. examples: - USD direction: allOf: - $ref: '#/components/schemas/CallDirection' description: The direction of the call. answered_by: anyOf: - $ref: '#/components/schemas/AnsweredBy' - type: 'null' description: Who/what the call was answered by. api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' forwarded_from: anyOf: - type: string - type: 'null' description: The number this call was forwarded from. Always null. examples: - null caller_name: anyOf: - type: string - type: 'null' description: The caller name. Always null. examples: - null uri: type: string description: The URI for the call. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472ca.json subresource_uris: allOf: - $ref: '#/components/schemas/CallSubresourceUris' description: A Map of available sub-resources. annotation: anyOf: - type: string - type: 'null' description: The annotation for the call. Always null. examples: - null group_sid: anyOf: - type: string - type: 'null' description: The group SID for the call. Always null. examples: - null audio_in_mos: anyOf: - type: number format: float - type: 'null' description: The Mean Opinion Score for audio quality (1.0-5.0). examples: - 4.5 sip_result_code: anyOf: - type: string - type: 'null' description: The SIP result code for the call. examples: - '200' audio_rtt_avg: anyOf: - type: integer format: int32 - type: 'null' description: The average round-trip time for audio in milliseconds. examples: - 50 audio_rtt_min: anyOf: - type: integer format: int32 - type: 'null' description: The minimum round-trip time for audio in milliseconds. examples: - 20 audio_rtt_max: anyOf: - type: integer format: int32 - type: 'null' description: The maximum round-trip time for audio in milliseconds. examples: - 100 audio_out_jitter_min: anyOf: - type: integer format: int32 - type: 'null' description: The minimum outbound audio jitter in milliseconds. examples: - 1 audio_out_jitter_max: anyOf: - type: integer format: int32 - type: 'null' description: The maximum outbound audio jitter in milliseconds. examples: - 10 audio_out_jitter_avg: anyOf: - type: integer format: int32 - type: 'null' description: The average outbound audio jitter in milliseconds. examples: - 5 audio_out_lost: anyOf: - type: integer format: int32 - type: 'null' description: The number of outbound audio packets lost. examples: - 0 unevaluatedProperties: not: {} description: Response containing a single call. CallStatus: type: string enum: - queued - ringing - in-progress - canceled - completed - busy - failed - no-answer description: Call status. CallStreamResponse: type: object required: - sid - account_sid - call_sid - name - status - date_updated - uri properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the stream. examples: - b3877c40-da60-4998-90ad-b792e98472st account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account. examples: - b3877c40-da60-4998-90ad-b792e98472af call_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the call. examples: - b3877c40-da60-4998-90ad-b792e98472ca name: type: string description: The name of the stream. examples: - my_first_stream status: allOf: - $ref: '#/components/schemas/StreamStatus' description: The status of the stream. date_updated: type: string description: The date, in RFC 2822 GMT format, this stream was updated. examples: - Wed, 19 Sep 2018 21:00:00 +0000 uri: type: string description: The URI for the stream. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472ca/Streams/b3877c40-da60-4998-90ad-b792e98472st.json unevaluatedProperties: not: {} description: Response containing a single call stream. CallSubresourceUris: type: object required: - notifications - recordings properties: notifications: anyOf: - type: string - type: 'null' description: The URI for notifications. Always null. examples: - null recordings: type: string description: The URI for recordings. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472ca/Recordings.json unevaluatedProperties: not: {} description: Call subresource URIs. CompatibilityErrorArrayItem: type: object properties: code: type: string description: The numeric string identifying the API error code examples: - '30010' message: type: string description: Error text examples: - Maxpriceperminute was exceeded. This call's cost is 0.008 per minute. more_info: type: string description: Url for more information on error code examples: - https://signalwire.com/docs/rest/compatibility-api/error-codes unevaluatedProperties: not: {} description: Error item in the errors array format. CompatibilityErrorArrayResponse: type: object properties: errors: type: array items: $ref: '#/components/schemas/CompatibilityErrorArrayItem' description: A list of errors unevaluatedProperties: not: {} description: Error response with errors array format. CompatibilityErrorResponse: type: object required: - code - message - more_info - status properties: code: type: integer format: int32 description: Error code. examples: - 20003 message: type: string description: Error message. examples: - Authentication failed more_info: type: string description: URL for more information about the error. examples: - https://signalwire.com/docs/compatibility-api/reference/errors status: type: integer format: int32 description: HTTP status code. examples: - 401 unevaluatedProperties: not: {} description: Error response model. CompatibilityErrorStringArrayResponse: type: object required: - errors properties: errors: type: array items: type: string description: List of validation error messages. examples: - - Validation error message unevaluatedProperties: not: {} description: Error response with errors array of strings format. CompatibilityImportedPhoneNumberError: type: object properties: code: type: string description: The error code. examples: - '10000' message: type: string description: A human-readable error message. examples: - Number type can't be blank more_info: type: string description: A URL to more information about the error. examples: - https://signalwire.com/docs/rest/compatibility-api/overview/error-codes status: type: integer format: int32 description: The HTTP status code. examples: - 400 unevaluatedProperties: not: {} description: Error response model with string code for ImportedPhoneNumbers. CompatibilityTokenValidationError: type: object properties: type: type: string description: Error type. code: type: string description: Error code. message: type: string description: Error message. attribute: type: string description: Request parameter associated with this error. url: type: string format: uri description: Link to developer resource for this error. unevaluatedProperties: not: {} description: Token validation error response model. Conference: type: object required: - sid - account_sid - date_created - date_updated - friendly_name - status - api_version - region - uri - subresource_uris properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for this conference. examples: - b3877c40-da60-4998-90ad-b792e98472cf account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that created this conference. examples: - b3877c40-da60-4998-90ad-b792e98472af date_created: type: string description: The date, in RFC 2822 format, this conference was created. examples: - Mon, 24 Sept 2018 21:00:00 +0000 date_updated: type: string description: The date, in RFC 2822 format, this conference was updated. examples: - Tue, 25 Sept 2018 20:00:00 +0000 friendly_name: type: string description: A description, up to 64 characters, of the conference room. examples: - My Conference Room status: allOf: - $ref: '#/components/schemas/ConferenceStatus' description: The status of this conference. api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' region: type: string description: The region where this conference audio was mixed. examples: - us1 uri: type: string description: The URI for this conference. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences/b3877c40-da60-4998-90ad-b792e98472cf.json subresource_uris: allOf: - $ref: '#/components/schemas/ConferenceSubresourceUris' description: The links to associated subresources. unevaluatedProperties: not: {} description: Conference model. ConferenceListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - conferences properties: uri: type: string description: The URI of the current page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences?PageToken=PA1234 first_page_uri: type: string description: The URI of the first page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences next_page_uri: anyOf: - type: string - type: 'null' description: The URI of the next page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences?Page=1&PageToken=PA5678 previous_page_uri: anyOf: - type: string - type: 'null' description: The URI of the previous page. examples: - null page: type: integer format: int32 description: The current page number. examples: - 0 page_size: type: integer format: int32 description: The number of items per page. examples: - 50 conferences: type: array items: $ref: '#/components/schemas/Conference' description: List of conferences. unevaluatedProperties: not: {} description: Response containing a list of conferences. ConferenceParticipant: type: object required: - account_sid - call_sid - call_sid_to_coach - coaching - conference_sid - date_created - status - date_updated - end_conference_on_exit - muted - hold - start_conference_on_enter - uri properties: account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that created this conference. examples: - b3877c40-da60-4998-90ad-b792e98472af call_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the Participant call connected to this conference. examples: - b3877c40-da60-4998-90ad-b792e98472ca call_sid_to_coach: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier of the participant who is being coached. examples: - b3877c40-da60-4998-90ad-b792e98472co coaching: type: boolean description: Whether the participant is coaching another call. examples: - false conference_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the conference this participant is in. examples: - b3877c40-da60-4998-90ad-b792e98472cf date_created: type: string description: The date, in RFC 2822 format, this conference participant was created. examples: - Mon, 24 Sept 2018 21:00:00 +0000 status: allOf: - $ref: '#/components/schemas/ParticipantStatus' description: The status of the conference call. date_updated: type: string description: The date, in RFC 2822 format, this conference participant was updated. examples: - Tue, 25 Sept 2018 20:00:00 +0000 end_conference_on_exit: type: boolean description: Whether or not a conference ends when a participant leaves the conference call. examples: - false muted: type: boolean description: Whether or not a participant is muted. examples: - false hold: type: boolean description: Whether or not a participant is on hold. examples: - false start_conference_on_enter: type: boolean description: Whether or not a conference will begin when this participant enters the conference call. examples: - true uri: type: string description: The URI for this conference participant. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences/b3877c40-da60-4998-90ad-b792e98472cf/Participants/b3877c40-da60-4998-90ad-b792e98472ca.json unevaluatedProperties: not: {} description: Conference participant model. ConferenceParticipantListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - participants properties: uri: type: string description: The URI of the current page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences/b3877c40-da60-4998-90ad-b792e98472cf/Participants?PageToken=PA1234 first_page_uri: type: string description: The URI of the first page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences/b3877c40-da60-4998-90ad-b792e98472cf/Participants next_page_uri: anyOf: - type: string - type: 'null' description: The URI of the next page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences/b3877c40-da60-4998-90ad-b792e98472cf/Participants?Page=1&PageToken=PA5678 previous_page_uri: anyOf: - type: string - type: 'null' description: The URI of the previous page. examples: - null page: type: integer format: int32 description: The current page number. examples: - 0 page_size: type: integer format: int32 description: The number of items per page. examples: - 50 participants: type: array items: $ref: '#/components/schemas/ConferenceParticipant' description: List of participants. unevaluatedProperties: not: {} description: Response containing a list of conference participants. ConferenceParticipantResponse: type: object required: - account_sid - call_sid - call_sid_to_coach - coaching - conference_sid - date_created - status - date_updated - end_conference_on_exit - muted - hold - start_conference_on_enter - uri properties: account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that created this conference. examples: - b3877c40-da60-4998-90ad-b792e98472af call_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the Participant call connected to this conference. examples: - b3877c40-da60-4998-90ad-b792e98472ca call_sid_to_coach: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier of the participant who is being coached. examples: - b3877c40-da60-4998-90ad-b792e98472co coaching: type: boolean description: Whether the participant is coaching another call. examples: - false conference_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the conference this participant is in. examples: - b3877c40-da60-4998-90ad-b792e98472cf date_created: type: string description: The date, in RFC 2822 format, this conference participant was created. examples: - Mon, 24 Sept 2018 21:00:00 +0000 status: allOf: - $ref: '#/components/schemas/ParticipantStatus' description: The status of the conference call. date_updated: type: string description: The date, in RFC 2822 format, this conference participant was updated. examples: - Tue, 25 Sept 2018 20:00:00 +0000 end_conference_on_exit: type: boolean description: Whether or not a conference ends when a participant leaves the conference call. examples: - false muted: type: boolean description: Whether or not a participant is muted. examples: - false hold: type: boolean description: Whether or not a participant is on hold. examples: - false start_conference_on_enter: type: boolean description: Whether or not a conference will begin when this participant enters the conference call. examples: - true uri: type: string description: The URI for this conference participant. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences/b3877c40-da60-4998-90ad-b792e98472cf/Participants/b3877c40-da60-4998-90ad-b792e98472ca.json unevaluatedProperties: not: {} description: Response containing a single conference participant. ConferenceRecording: type: object required: - sid - account_sid - api_version - call_sid - conference_sid - channel - channels - date_created - date_updated - start_time - end_time - duration - price - price_unit - source - status - error_code - uri - subresource_uris - encryption_details - trim properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the recording. examples: - 19e436af-5688-4307-b03b-bdb2b42b8142 account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that is associated with this recording. examples: - 720796a0-8ee9-4350-83bd-2d07a3121f1e api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' call_sid: anyOf: - type: string - type: 'null' description: The unique identifier for the call. Always null for conference recordings. examples: - null conference_sid: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier for the conference that is associated with this recording. examples: - 43bb71ee-553f-4074-bb20-8e2747647cce channel: type: string enum: - '1' - '2' description: The number of channels in a recording (singular key). Returns '1' for mono or '2' for stereo. examples: - '1' channels: type: string enum: - '1' - '2' description: The number of channels in a recording. Returns '1' for mono or '2' for stereo. examples: - '1' date_created: type: string description: The date, in RFC 2822 format, this recording was created. examples: - Tue, 25 Sep 2018 23:00:00 +0000 date_updated: type: string description: The date, in RFC 2822 format, this recording was updated. examples: - Wed, 26 Sep 2018 23:00:04 +0000 start_time: anyOf: - type: string - type: 'null' description: The time, in RFC 2822 format, this recording started. examples: - Tue, 25 Sep 2018 23:00:00 +0000 end_time: anyOf: - type: string - type: 'null' description: The time, in RFC 2822 format, this recording ended. examples: - Wed, 26 Sep 2018 23:00:04 +0000 duration: type: integer format: int32 description: The length, in seconds, of the recording. examples: - 4 price: anyOf: - type: string - type: 'null' description: The cost for the recording. examples: - '-0.0025' price_unit: type: string description: The currency of the price of the recording. examples: - USD source: allOf: - $ref: '#/components/schemas/ConferenceRecordingSource' description: How the recording was made. status: allOf: - $ref: '#/components/schemas/ConferenceRecordingStatus' description: The status of the recording. error_code: anyOf: - type: string - type: 'null' description: Further details about a failed recording. examples: - null uri: type: string description: The URI of the recording. examples: - /api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Conferences/43bb71ee-553f-4074-bb20-8e2747647cce/Recordings/19e436af-5688-4307-b03b-bdb2b42b8142.json subresource_uris: allOf: - $ref: '#/components/schemas/ConferenceRecordingSubresourceUris' description: Subresource URIs. encryption_details: anyOf: - type: string - type: 'null' description: Encryption details. Always null. examples: - null trim: type: string description: Whether leading and trailing silence is trimmed from a recording. examples: - do-not-trim unevaluatedProperties: not: {} description: Conference recording model. ConferenceRecordingListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - recordings properties: uri: type: string description: The URI of the current page. examples: - /api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Conferences/43bb71ee-553f-4074-bb20-8e2747647cce/Recordings?PageToken=PA1234 first_page_uri: type: string description: The URI of the first page. examples: - /api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Conferences/43bb71ee-553f-4074-bb20-8e2747647cce/Recordings next_page_uri: anyOf: - type: string - type: 'null' description: The URI of the next page. examples: - /api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Conferences/43bb71ee-553f-4074-bb20-8e2747647cce/Recordings?Page=1&PageToken=PA5678 previous_page_uri: anyOf: - type: string - type: 'null' description: The URI of the previous page. examples: - null page: type: integer format: int32 description: The current page number. examples: - 0 page_size: type: integer format: int32 description: The number of items per page. examples: - 50 recordings: type: array items: $ref: '#/components/schemas/ConferenceRecording' description: List of recordings. unevaluatedProperties: not: {} description: Response containing a list of conference recordings. ConferenceRecordingResponse: type: object required: - sid - account_sid - api_version - call_sid - conference_sid - channel - channels - date_created - date_updated - start_time - end_time - duration - price - price_unit - source - status - error_code - uri - subresource_uris - encryption_details - trim properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the recording. examples: - 19e436af-5688-4307-b03b-bdb2b42b8142 account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that is associated with this recording. examples: - 720796a0-8ee9-4350-83bd-2d07a3121f1e api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' call_sid: anyOf: - type: string - type: 'null' description: The unique identifier for the call. Always null for conference recordings. examples: - null conference_sid: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier for the conference that is associated with this recording. examples: - 43bb71ee-553f-4074-bb20-8e2747647cce channel: type: string enum: - '1' - '2' description: The number of channels in a recording (singular key). Returns '1' for mono or '2' for stereo. examples: - '1' channels: type: string enum: - '1' - '2' description: The number of channels in a recording. Returns '1' for mono or '2' for stereo. examples: - '1' date_created: type: string description: The date, in RFC 2822 format, this recording was created. examples: - Tue, 25 Sep 2018 23:00:00 +0000 date_updated: type: string description: The date, in RFC 2822 format, this recording was updated. examples: - Wed, 26 Sep 2018 23:00:04 +0000 start_time: anyOf: - type: string - type: 'null' description: The time, in RFC 2822 format, this recording started. examples: - Tue, 25 Sep 2018 23:00:00 +0000 end_time: anyOf: - type: string - type: 'null' description: The time, in RFC 2822 format, this recording ended. examples: - Wed, 26 Sep 2018 23:00:04 +0000 duration: type: integer format: int32 description: The length, in seconds, of the recording. examples: - 4 price: anyOf: - type: string - type: 'null' description: The cost for the recording. examples: - '-0.0025' price_unit: type: string description: The currency of the price of the recording. examples: - USD source: allOf: - $ref: '#/components/schemas/ConferenceRecordingSource' description: How the recording was made. status: allOf: - $ref: '#/components/schemas/ConferenceRecordingStatus' description: The status of the recording. error_code: anyOf: - type: string - type: 'null' description: Further details about a failed recording. examples: - null uri: type: string description: The URI of the recording. examples: - /api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Conferences/43bb71ee-553f-4074-bb20-8e2747647cce/Recordings/19e436af-5688-4307-b03b-bdb2b42b8142.json subresource_uris: allOf: - $ref: '#/components/schemas/ConferenceRecordingSubresourceUris' description: Subresource URIs. encryption_details: anyOf: - type: string - type: 'null' description: Encryption details. Always null. examples: - null trim: type: string description: Whether leading and trailing silence is trimmed from a recording. examples: - do-not-trim unevaluatedProperties: not: {} description: Response containing a single conference recording. ConferenceRecordingSource: type: string enum: - Conference - StartConferenceRecording description: Recording source for conference recordings. ConferenceRecordingStatus: type: string enum: - queued - in-progress - paused - resumed - completed - absent - stopped description: Recording status. ConferenceRecordingSubresourceUris: type: object required: - transcriptions properties: transcriptions: type: string description: The URI for transcriptions. examples: - /api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Recordings/19e436af-5688-4307-b03b-bdb2b42b8142/Transcriptions.json unevaluatedProperties: not: {} description: Recording subresource URIs. ConferenceResponse: type: object required: - sid - account_sid - date_created - date_updated - friendly_name - status - api_version - region - uri - subresource_uris properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for this conference. examples: - b3877c40-da60-4998-90ad-b792e98472cf account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that created this conference. examples: - b3877c40-da60-4998-90ad-b792e98472af date_created: type: string description: The date, in RFC 2822 format, this conference was created. examples: - Mon, 24 Sept 2018 21:00:00 +0000 date_updated: type: string description: The date, in RFC 2822 format, this conference was updated. examples: - Tue, 25 Sept 2018 20:00:00 +0000 friendly_name: type: string description: A description, up to 64 characters, of the conference room. examples: - My Conference Room status: allOf: - $ref: '#/components/schemas/ConferenceStatus' description: The status of this conference. api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' region: type: string description: The region where this conference audio was mixed. examples: - us1 uri: type: string description: The URI for this conference. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences/b3877c40-da60-4998-90ad-b792e98472cf.json subresource_uris: allOf: - $ref: '#/components/schemas/ConferenceSubresourceUris' description: The links to associated subresources. unevaluatedProperties: not: {} description: Response containing a single conference. ConferenceStatus: type: string enum: - init - in-progress - completed description: Conference status. ConferenceStreamResponse: type: object required: - account_sid - conference_sid - date_updated - name - sid - status - uri properties: account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account. examples: - b3877c40-da60-4998-90ad-b792e98472af conference_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the conference. examples: - b3877c40-da60-4998-90ad-b792e98472cf date_updated: type: string description: The date, in RFC 2822 GMT format, this stream was updated. examples: - Tue, 25 Sept 2018 20:00:00 +0000 name: anyOf: - type: string - type: 'null' description: The name of the stream. May be null if not specified when creating the stream. examples: - my_conference_stream sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the stream. examples: - b3877c40-da60-4998-90ad-b792e98472st status: allOf: - $ref: '#/components/schemas/ConferenceStreamStatus' description: The status of the stream. uri: type: string description: The URI for the stream. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences/b3877c40-da60-4998-90ad-b792e98472cf/Streams/b3877c40-da60-4998-90ad-b792e98472st.json unevaluatedProperties: not: {} description: Response containing a single conference stream. ConferenceStreamStatus: type: string enum: - queued - in-progress - stopped description: Conference stream status. ConferenceSubresourceUris: type: object required: - participants - recordings properties: participants: type: string description: Links to the participants. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences/b3877c40-da60-4998-90ad-b792e98472cf/Participants.json recordings: type: string description: Links to the recordings. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences/b3877c40-da60-4998-90ad-b792e98472cf/Recordings.json unevaluatedProperties: not: {} description: Conference subresource URIs. CountryResource: type: object required: - country_code - country - uri - beta - subresource_uris properties: country_code: type: string description: The ISO country code of the number. examples: - US country: type: string description: The country the number is from. examples: - United States uri: type: string description: The URI for the API call. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/AvailablePhoneNumbers/US beta: type: boolean description: Always `false`. Included for Twilio API compatibility. examples: - false subresource_uris: allOf: - $ref: '#/components/schemas/CountrySubresourceUris' description: URIs for subresources. unevaluatedProperties: not: {} description: Country resource for available phone numbers. CountrySubresourceUris: type: object required: - local - toll_free properties: local: type: string description: The URI for local numbers. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/AvailablePhoneNumbers/US/Local toll_free: type: string description: The URI for toll-free numbers. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/AvailablePhoneNumbers/US/TollFree unevaluatedProperties: not: {} description: Country subresource URIs. CreateApplicationRequest: type: object required: - FriendlyName properties: FriendlyName: type: string maxLength: 64 description: A named unique identifier for the resource. examples: - My Friendly Name VoiceUrl: type: string format: uri description: The URL to request when a phone number receives a call or fax. examples: - http://example.com VoiceMethod: type: string enum: - GET - POST description: Whether the request to `VoiceUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST VoiceFallbackUrl: type: string format: uri description: The URL SignalWire will request if errors occur when fetching the `VoiceUrl`. examples: - http://example.com VoiceFallbackMethod: type: string enum: - GET - POST description: Whether the request to `VoiceFallbackUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST StatusCallback: type: string format: uri description: The URL to pass status updates to the Application. examples: - http://example.com StatusCallbackMethod: type: string enum: - GET - POST description: Whether the request to the `StatusCallback` URL is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST SmsUrl: type: string format: uri description: The URL to request when an SMS is received. examples: - http://example.com SmsMethod: type: string enum: - GET - POST description: Whether the request to `SmsUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST SmsFallbackUrl: type: string format: uri description: The URL SignalWire will request if errors occur when fetching the `SmsUrl`. examples: - http://www.example.com/sms-fallback SmsFallbackMethod: type: string enum: - GET - POST description: Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST SmsStatusCallback: type: string format: uri description: The URL to receive status updates for messages sent via this Application. examples: - http://www.example.com/sms-status-callback SmsStatusCallbackMethod: type: string enum: - GET - POST description: Whether the request to `SmsStatusCallback` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST unevaluatedProperties: not: {} description: Request body for creating an application. CreateCallRecordingRequest: type: object properties: RecordingChannels: type: string enum: - mono - dual description: The number of channels in the recording. Can be `mono` (both legs of call recorded under one channel into one recording file) or `dual` (each leg of call recorded in separate channels into one recording file). Default is `mono`. examples: - mono default: mono RecordingStatusCallback: type: string format: uri description: The URL to request to when recording is available. See the [Recording status callback](/docs/compatibility-api/rest/recordings/webhooks/recording-status-callback) webhook for the payload your URL will receive. examples: - https://your-api-endpoint.com/recording-status RecordingStatusCallbackEvent: type: string description: 'The different recording statuses. To specify multiple events, separate with a space. Valid values: completed, in-progress, absent. Default is `completed`.' examples: - completed default: completed RecordingStatusCallbackMethod: type: string enum: - GET - POST description: Whether the request to `RecordingStatusCallback` URL is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST RecordingTrack: type: string enum: - inbound - outbound - both description: Specifies whether to record the `inbound` audio to SignalWire from the called party or the `outbound` audio from SignalWire to the called party or `both` the inbound and outbound audio. Default is `both`. examples: - both default: both Trim: type: string enum: - trim-silence - do-not-trim description: Whether leading and trailing silence is trimmed from a recording. Default is `do-not-trim`. examples: - do-not-trim default: do-not-trim unevaluatedProperties: not: {} description: Request body for creating a call recording. CreateCallRequest: type: object required: - To - From properties: To: type: string description: The address that received the call. Can be a phone number in E.164 format, a SIP URI, or a client identifier. examples: - '+13105678901' From: type: string description: The address that initiated the call. Must be a phone number in E.164 format for PSTN calls. examples: - '+13103384645' Url: type: string format: uri description: The URL to handle the call. Required if `ApplicationSid` and `Laml`/`Twiml` are not used. examples: - http://your-application.com/docs/voice.xml ApplicationSid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier of the application used to handle the call. Required if `Url` and `Laml`/`Twiml` are not used. examples: - b3877c40-da60-4998-90ad-b792e98472ap Method: type: string enum: - GET - POST description: Whether the request to `Url` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST FallbackUrl: type: string format: uri description: The URL SignalWire will request if errors occur when fetching the `Url`. examples: - https://your-api-endpoint.com/path FallbackMethod: type: string enum: - GET - POST description: Whether the request to `FallbackUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST StatusCallback: type: string format: uri description: The URL SignalWire will send webhooks to on every requested `StatusCallbackEvent` event. See the [Voice status callback](/docs/compatibility-api/rest/calls/webhooks/voice-status-callback) webhook for the payload your URL will receive. examples: - https://your-api-endpoint.com/path StatusCallbackMethod: type: string enum: - GET - POST description: Whether the request to `StatusCallback` URL is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST StatusCallbackEvent: type: array items: type: string description: 'The status events that trigger a SignalWire webhook. Valid values: initiated, ringing, answered, completed, ringing_forwarded, ringing_queued. Defaults to `completed`.' examples: - - initiated - ringing - answered - completed default: - completed CallerId: type: string description: The number, in E.164 format, or identifier of the caller. Used to override the From for caller ID purposes. examples: - '+13102259067' SendDigits: type: string maxLength: 32 pattern: ^[\d#*wW]{1,32}$ description: 'The digits to press after a call is connected. Valid characters are 0-9, #, *, w (wait 0.5s), and W (wait 1s).' examples: - 1ww2 Timeout: type: integer format: int32 minimum: 1 maximum: 600 description: The time in seconds SignalWire will wait before assuming the call has no answer. Default is `60` seconds. examples: - 60 default: 60 MachineDetection: type: string enum: - Enable - DetectMessageEnd - none description: Whether a human or machine picked up the call. Default is `none`. examples: - Enable default: none MachineDetectionTimeout: type: integer format: int32 minimum: 1 maximum: 120 description: The time in seconds SignalWire will wait for machine detection before timing out. Default is `30` seconds. examples: - 30 default: 30 MachineDetectionSpeechThreshold: type: integer format: int32 minimum: 1000 maximum: 6000 description: How many milliseconds of voice to decide it is a machine. Default is `2400` milliseconds. examples: - 2400 default: 2400 MachineDetectionSpeechEndThreshold: type: integer format: int32 minimum: 500 maximum: 5000 description: Number of milliseconds to wait for voice to finish. Default is `1200` milliseconds. examples: - 1200 default: 1200 MachineDetectionSilenceTimeout: type: integer format: int32 minimum: 2000 maximum: 10000 description: Number of milliseconds to wait for initial voice before giving up. Default is `5000` milliseconds. examples: - 5000 default: 5000 MachineWordsThreshold: type: integer format: int32 minimum: 1 maximum: 100 description: How many words to count to decide it is a machine. Default is `6`. examples: - 6 default: 6 AsyncAmd: type: boolean description: Whether or not to execute machine detection asynchronously. Default is `false`. examples: - false default: false AsyncAmdStatusCallbackMethod: type: string enum: - GET - POST description: Whether the request to `AsyncAmdStatusCallback` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST AsyncAmdStatusCallback: type: string format: uri description: The URL to request when the machine detection is completed. examples: - https://your-api-endpoint.com/path AsyncAmdPartialResults: type: boolean description: Whether or not to report partial (interim) results to the callback url. Default is `false`. examples: - false default: false Record: type: boolean description: Whether or not to record a call. Default is `false`. examples: - false default: false RecordingChannels: type: string enum: - mono - dual description: The number of channels in the recording. Default is `mono`. examples: - mono default: mono RecordingTrack: type: string enum: - inbound - outbound - both description: Specifies whether to record the `inbound`, `outbound`, or `both` audio. Default is `both`. examples: - both default: both RecordingStatusCallback: type: string format: uri description: The URL to request when recording is available. See the [Recording status callback](/docs/compatibility-api/rest/recordings/webhooks/recording-status-callback) webhook for the payload your URL will receive. examples: - https://your-api-endpoint.com/path RecordingStatusCallbackMethod: type: string enum: - GET - POST description: Whether the request to `RecordingStatusCallback` URL is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST RecordingStatusCallbackEvent: type: string description: 'The recording status events that trigger a webhook. Space-separated list. Valid values: completed, in-progress, absent. Default is `completed`.' examples: - completed default: completed Trim: type: string enum: - trim-silence - do-not-trim description: Whether leading and trailing silence is trimmed from a recording. Default is `trim-silence`. examples: - trim-silence default: trim-silence SipAuthUsername: type: string description: The username to authenticate the caller when making an outbound SIP call. examples: - sipuser SipAuthPassword: type: string description: The password to authenticate the caller when making an outbound SIP call. examples: - sippassword MaxPricePerMinute: type: string pattern: ^\d+\.?\d{0,4}$ description: 'The maximum price in USD acceptable for the call to be created. Format: up to 4 decimal places.' examples: - '0.0075' unevaluatedProperties: not: {} description: Request body for creating a call. CreateCallStreamRequest: type: object required: - Url properties: Name: type: string description: Unique name for the Stream, per Call. It is used to stop a Stream by name. examples: - my_first_stream Track: type: string enum: - inbound_track - outbound_track - both_tracks description: This attribute can be one of inbound_track, outbound_track, both_tracks. Default is `both_tracks`. examples: - both_tracks default: both_tracks StatusCallbackMethod: type: string enum: - GET - POST description: Whether the request to `StatusCallback` URL is a `GET` or a `POST`. Default is `POST`. examples: - GET default: POST StatusCallback: type: string format: uri description: The URL to request to when stream is available. examples: - https://your-api-endpoint.com/stream-status Url: type: string format: uri description: Absolute or relative URL. A WebSocket connection to the url will be established and audio will start flowing towards the Websocket server. The only supported protocol is wss. For security reasons ws is NOT supported. examples: - wss://your-application.com/audiostream Parameter1.Name: type: string description: Custom parameter name to pass towards the WebSocket server. You can pass up to 99 custom parameters using `Parameter1.Name` through `Parameter99.Name`. examples: - FirstName Parameter1.Value: type: string description: Custom parameter value to pass towards the WebSocket server. You can pass up to 99 custom parameters using `Parameter1.Value` through `Parameter99.Value`. examples: - Jane Parameter2.Name: type: string description: Custom parameter name to pass towards the WebSocket server. examples: - LastName Parameter2.Value: type: string description: Custom parameter value to pass towards the WebSocket server. examples: - Doe AuthorizationBearerToken: type: string description: Bearer token for authorization with the WebSocket server. examples: - your-bearer-token unevaluatedProperties: not: {} description: Request body for creating a call stream. CreateConferenceStreamRequest: type: object required: - Url properties: Name: type: string description: Unique name for the Stream, per Conference. It is used to stop a Stream by name. examples: - my_conference_stream Track: type: string enum: - inbound_track - outbound_track - both_tracks description: This attribute can be one of inbound_track, outbound_track, both_tracks. Default is `both_tracks`. examples: - both_tracks default: both_tracks StatusCallbackMethod: type: string enum: - GET - POST description: Whether the request to `StatusCallback` URL is a `GET` or a `POST`. Default is `POST`. examples: - GET default: POST StatusCallback: type: string format: uri description: The URL to request to when stream is available. examples: - https://your-api-endpoint.com/stream-status Url: type: string format: uri description: Absolute or relative URL. A WebSocket connection to the url will be established and audio will start flowing towards the Websocket server. The only supported protocol is wss. For security reasons ws is NOT supported. examples: - wss://your-application.com/audiostream StreamCodec: type: string enum: - PCMU - PCMA - L16 - L16@16000h - L16@24000h description: The audio codec to use for the stream. examples: - PCMU StreamRealTime: type: boolean description: Enable real-time streaming for the conference stream. examples: - true Parameter1.Name: type: string description: Custom parameter name to pass towards the WebSocket server. You can pass up to 99 custom parameters using `Parameter1.Name` through `Parameter99.Name`. examples: - FirstName Parameter1.Value: type: string description: Custom parameter value to pass towards the WebSocket server. You can pass up to 99 custom parameters using `Parameter1.Value` through `Parameter99.Value`. examples: - Jane Parameter2.Name: type: string description: Custom parameter name to pass towards the WebSocket server. examples: - LastName Parameter2.Value: type: string description: Custom parameter value to pass towards the WebSocket server. examples: - Doe AuthorizationBearerToken: type: string description: Bearer token for authorization with the WebSocket server. examples: - your-bearer-token unevaluatedProperties: not: {} description: Request body for creating a conference stream. CreateCxmlScriptRequest: type: object required: - Name properties: Name: type: string minLength: 1 description: A friendly name given to the cXML script. Required. examples: - Death Star IVR Contents: type: string description: The cXML contents of the script. Must be valid XML with proper Mustache syntax if templates are used. Defaults to an empty Response element. examples: - Hello! unevaluatedProperties: not: {} description: Request body for creating a cXML script. CreateIncomingPhoneNumberRequest: type: object required: - PhoneNumber properties: PhoneNumber: type: string minLength: 6 maxLength: 18 pattern: ^\+\d{5,17}$ description: The phone number to purchase in E.164 format. Must start with `+` followed by 5-17 digits. examples: - '+13103386745' FriendlyName: type: string description: A friendly name for the phone number. If not provided, the formatted phone number will be used. examples: - My Business Line SmsApplicationSid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the application associated with SMS handling on this phone number. examples: - b3877c40-da60-4998-90ad-b792e98472sa SmsFallbackMethod: type: string enum: - GET - POST description: Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST SmsFallbackUrl: type: string format: uri description: The URL to request if errors occur when fetching SmsUrl. examples: - https://example.com/sms-fallback SmsMethod: type: string enum: - GET - POST description: Whether the request to SmsUrl is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST SmsUrl: type: string format: uri description: The URL to request when an incoming SMS is received. examples: - https://example.com/sms StatusCallback: type: string format: uri description: The URL to request to pass status updates to. See the [Incoming call status callback](/docs/compatibility-api/rest/incoming-phone-numbers/webhooks/incoming-call-status-callback) webhook for the payload your URL will receive. examples: - https://example.com/status StatusCallbackMethod: type: string enum: - GET - POST description: Whether the request to StatusCallback is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST VoiceApplicationSid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the application associated with call handling on this phone number. examples: - b3877c40-da60-4998-90ad-b792e98472va VoiceFallbackMethod: type: string enum: - GET - POST description: Whether the request to VoiceFallbackUrl is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST VoiceFallbackUrl: type: string format: uri description: The URL to request if errors occur when fetching VoiceUrl. examples: - https://example.com/voice-fallback VoiceMethod: type: string enum: - GET - POST description: Whether the request to VoiceUrl is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST VoiceReceiveMode: type: string enum: - voice - fax description: Whether this number can receive voice calls or faxes. Default is `voice`. examples: - voice default: voice VoiceUrl: type: string format: uri description: The URL to request when an incoming call is received. examples: - https://example.com/voice unevaluatedProperties: not: {} description: Request body for creating an incoming phone number. CreateMessageRequest: type: object required: - To properties: To: type: string description: The phone number in E.164 format that will receive the message. examples: - '+15557654321' From: type: string description: The phone number in E.164 format that will send the message. Either `From` or `MessagingServiceSid` must be provided. examples: - '+15551234567' Body: type: string description: The text of the message. Either `Body` or `MediaUrl` must be provided. examples: - Hello World! MediaUrl: anyOf: - type: string - type: array items: type: string format: uri description: URL(s) of media you wish to attach and send with the message. Can be specified multiple times for up to 8 media items. examples: - https://example.com/image.jpg SendAsMms: type: boolean description: When set to true, forces the message to be sent as an MMS. examples: - false ApplicationSid: allOf: - $ref: '#/components/schemas/uuid' description: The SID of a SignalWire cXML Application used to configure the message's status callback. examples: - b3877c40-da60-4998-90ad-b792e98472ap MaxPrice: type: string pattern: ^\d+\.?\d{0,4}$ description: 'The maximum price in USD acceptable for the message to be sent. Format: decimal with up to 4 decimal places.' examples: - '0.0075' StatusCallback: type: string format: uri description: A URL endpoint to receive callbacks each time the status of the message changes. See the [SMS status callback](/docs/compatibility-api/rest/messages/webhooks/sms-status-callback) webhook for the payload your URL will receive. examples: - https://example.com/status-callback ValidityPeriod: type: integer format: int32 minimum: 1 maximum: 172800 description: The number of seconds a message will allow being queued before canceling. Must be between 1 and 172800 (48 hours). Default is 14400 (4 hours). examples: - 14400 default: 14400 MessagingServiceSid: allOf: - $ref: '#/components/schemas/uuid' description: The ID of a number group to use when sending the message. Either `From` or `MessagingServiceSid` must be provided. examples: - b3877c40-da60-4998-90ad-b792e98472ms unevaluatedProperties: not: {} description: Request body for creating a message. CreateQueueRequest: type: object required: - FriendlyName properties: FriendlyName: type: string minLength: 1 pattern: ^\w+$ description: A unique name for the queue. Must contain only alphanumeric characters and underscores. examples: - Queue1 MaxSize: type: integer format: int32 description: The maximum number of calls that are allowed to wait in a queue. Must be a positive integer. exclusiveMinimum: 0 examples: - 100 unevaluatedProperties: not: {} description: Request body for creating a queue. CreateSubprojectRequest: type: object required: - FriendlyName properties: FriendlyName: type: string maxLength: 250 description: The name of the Project, up to 250 characters long. examples: - My Project unevaluatedProperties: not: {} description: Request body for creating a subproject. CreateTokenRequest: type: object required: - name - permissions properties: name: type: string minLength: 1 description: The name representing the project API token. examples: - John Doe's Token permissions: type: array items: type: string minItems: 1 description: 'The permissions you would like to enable for this project API token. Valid permissions are: calling, chat, datasphere, fax, management, messaging, numbers, pubsub, storage, tasking, and video.' examples: - - calling - fax - messaging subproject_id: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier of the subproject you would like to create a token for. Must belong to the parent project. examples: - 9a7fc048-984f-11ee-b9d1-0242ac120002 unevaluatedProperties: not: {} description: Request body for creating an API token. CxmlScript: type: object required: - sid - date_created - date_updated - date_last_accessed - account_sid - name - contents - request_url - num_requests - api_version - uri properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier of the cXML script on SignalWire. examples: - 5184b831-184f-4209-872d-ccdccc80f2f1 date_created: type: string description: The date and time, in ISO 8601 format, the script was created. examples: - '2019-11-26T20:00:00Z' date_updated: type: string description: The date and time, in ISO 8601 format, the script was updated. examples: - '2019-11-26T20:00:00Z' date_last_accessed: anyOf: - type: string - type: 'null' description: The date and time, in ISO 8601 format, the script was last accessed, or null if never accessed. examples: - '2020-06-05T20:00:00Z' account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account this script is associated with. examples: - b3877c40-da60-4998-90ad-b792e98472af name: type: string description: A friendly name given to the cXML script. examples: - Death Star IVR contents: type: string description: The contents of the cXML script. examples: - Hello! request_url: type: string format: uri description: The unique URL to the raw contents of the cXML script. examples: - https://example.signalwire.com/laml-bins/5184b831-184f-4209-872d-ccdccc80f2f1 num_requests: type: integer format: int32 description: The number of times this cXML script has been accessed. examples: - 42 api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' uri: type: string description: The URL of this resource. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/LamlBins/5184b831-184f-4209-872d-ccdccc80f2f1 unevaluatedProperties: not: {} description: cXML Script model. CxmlScriptListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - laml_bins properties: uri: type: string description: The URI of the current page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/LamlBins?Page=0&PageSize=50 first_page_uri: type: string description: The URI of the first page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/LamlBins?Page=0&PageSize=50 next_page_uri: anyOf: - type: string - type: 'null' description: The URI of the next page, or null if there are no more pages. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/LamlBins?Page=1&PageSize=50&PageToken=PAb3877c40da604998 previous_page_uri: anyOf: - type: string - type: 'null' description: The URI of the previous page, or null if this is the first page. examples: - null page: type: integer format: int32 description: The current page number. examples: - 0 page_size: type: integer format: int32 description: The number of items per page. examples: - 50 laml_bins: type: array items: $ref: '#/components/schemas/CxmlScript' description: List of cXML scripts. unevaluatedProperties: not: {} description: Response containing a list of cXML scripts. CxmlScriptResponse: type: object required: - sid - date_created - date_updated - date_last_accessed - account_sid - name - contents - request_url - num_requests - api_version - uri properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier of the cXML script on SignalWire. examples: - 5184b831-184f-4209-872d-ccdccc80f2f1 date_created: type: string description: The date and time, in ISO 8601 format, the script was created. examples: - '2019-11-26T20:00:00Z' date_updated: type: string description: The date and time, in ISO 8601 format, the script was updated. examples: - '2019-11-26T20:00:00Z' date_last_accessed: anyOf: - type: string - type: 'null' description: The date and time, in ISO 8601 format, the script was last accessed, or null if never accessed. examples: - '2020-06-05T20:00:00Z' account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account this script is associated with. examples: - b3877c40-da60-4998-90ad-b792e98472af name: type: string description: A friendly name given to the cXML script. examples: - Death Star IVR contents: type: string description: The contents of the cXML script. examples: - Hello! request_url: type: string format: uri description: The unique URL to the raw contents of the cXML script. examples: - https://example.signalwire.com/laml-bins/5184b831-184f-4209-872d-ccdccc80f2f1 num_requests: type: integer format: int32 description: The number of times this cXML script has been accessed. examples: - 42 api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' uri: type: string description: The URL of this resource. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/LamlBins/5184b831-184f-4209-872d-ccdccc80f2f1 unevaluatedProperties: not: {} description: Response containing a single cXML script. Fax: type: object required: - account_sid - api_version - date_created - date_updated - direction - from - media_url - media_sid - num_pages - price - price_unit - quality - sid - status - to - duration - links - url - error_code - error_message properties: account_sid: type: string description: The unique identifier for the account this fax is associated with. examples: - b3877c40-da60-4998-90ad-b792e98472ac api_version: type: string description: The version of the SignalWire API. examples: - v1 date_created: type: string description: The date and time, in ISO 8601 format, the fax was created. examples: - '2018-11-26T20:00:00Z' date_updated: type: string description: The date and time, in ISO 8601 format, the fax was updated. examples: - '2018-11-27T20:00:00Z' direction: allOf: - $ref: '#/components/schemas/FaxDirection' description: The direction of the fax. from: type: string description: The phone number, in E.164 format, the fax was sent from. examples: - '+13103383454' media_url: anyOf: - type: string - type: 'null' description: The URL hosting the received media, or null if not available. examples: - https://example.com/fax.pdf media_sid: type: string description: The unique identifier for the media instance associated with the fax instance. examples: - b3877c40-da60-4998-90ad-b792e98472me num_pages: anyOf: - type: string - type: 'null' description: The number of pages in the fax document, or null if not yet determined. examples: - '3' price: anyOf: - type: string - type: 'null' description: The cost of the fax, or null if not yet calculated. examples: - '-0.005' price_unit: type: string description: The currency, in ISO 4217 format, of the price. examples: - USD quality: allOf: - $ref: '#/components/schemas/FaxQuality' description: The quality of the fax. sid: type: string description: The unique identifier of the fax. examples: - b3877c40-da60-4998-90ad-b792e98472fx status: allOf: - $ref: '#/components/schemas/FaxStatus' description: The status of the fax. to: type: string description: The phone number, in E.164 format, the fax was sent to. examples: - '+13104456789' duration: type: integer format: int32 description: The time, in seconds, it took to deliver a fax. examples: - 5000 links: allOf: - $ref: '#/components/schemas/FaxLinks' description: The URL links for resources associated with the fax. url: type: string description: The URL of this resource. examples: - /fax/v1/Faxes/b3877c40-da60-4998-90ad-b792e98472fx error_code: anyOf: - type: string - type: 'null' description: Error code for this resource, or null if no error. examples: - null error_message: anyOf: - type: string - type: 'null' description: The description of this error, or null if no error. examples: - null unevaluatedProperties: not: {} description: Fax model. FaxDirection: type: string enum: - inbound - outbound description: Fax direction. FaxLinks: type: object required: - media properties: media: type: string description: Media associated with this fax. examples: - /fax/v1/Faxes/b3877c40-da60-4998-90ad-b792e98472fx/Media unevaluatedProperties: not: {} description: Fax links. FaxListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - faxes properties: uri: type: string description: The URI of the current page. examples: - /fax/v1/Faxes?Page=0&PageSize=50 first_page_uri: type: string description: The URI of the first page. examples: - /fax/v1/Faxes?PageSize=50 next_page_uri: anyOf: - type: string - type: 'null' description: The URI of the next page, or null if there are no more pages. examples: - /fax/v1/Faxes?Page=1&PageSize=50&PageToken=PAb3877c40da604998 previous_page_uri: anyOf: - type: string - type: 'null' description: The URI of the previous page, or null if this is the first page. examples: - null page: type: integer format: int32 description: The current page number. examples: - 0 page_size: type: integer format: int32 description: The number of items per page. examples: - 50 faxes: type: array items: $ref: '#/components/schemas/Fax' description: List of faxes. unevaluatedProperties: not: {} description: Response containing a list of faxes. FaxMedia: type: object required: - account_sid - content_type - date_created - date_updated - fax_sid - sid - uri - url properties: account_sid: type: string description: The unique identifier for the account. examples: - b3877c40-da60-4998-90ad-b792e98472ac content_type: type: string description: The content type of the media. examples: - application/pdf date_created: type: string description: The date, in ISO 8601 format, this media was created. examples: - '2018-11-26T20:00:00Z' date_updated: type: string description: The date, in ISO 8601 format, this media was updated. examples: - '2018-11-27T20:00:00Z' fax_sid: type: string description: The unique identifier for the fax. examples: - b3877c40-da60-4998-90ad-b792e98472fx sid: type: string description: The unique identifier for the media. examples: - b3877c40-da60-4998-90ad-b792e98472me uri: type: string description: The URI for the media. examples: - /fax/v1/Faxes/b3877c40-da60-4998-90ad-b792e98472fx/Media/b3877c40-da60-4998-90ad-b792e98472me.json url: type: string description: The URL for the media. examples: - /fax/v1/Faxes/b3877c40-da60-4998-90ad-b792e98472fx/Media/b3877c40-da60-4998-90ad-b792e98472me.json unevaluatedProperties: not: {} description: Fax media model. FaxMediaListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - media - fax_media properties: uri: type: string description: The URI of the current page. examples: - /fax/v1/Faxes/b3877c40-da60-4998-90ad-b792e98472fx/Media?Page=0&PageSize=50 first_page_uri: type: string description: The URI of the first page. examples: - /fax/v1/Faxes/b3877c40-da60-4998-90ad-b792e98472fx/Media?PageSize=50 next_page_uri: anyOf: - type: string - type: 'null' description: The URI of the next page, or null if there are no more pages. examples: - null previous_page_uri: anyOf: - type: string - type: 'null' description: The URI of the previous page, or null if this is the first page. examples: - null page: type: integer format: int32 description: The current page number. examples: - 0 page_size: type: integer format: int32 description: The number of items per page. examples: - 50 media: type: array items: $ref: '#/components/schemas/FaxMedia' description: List of media. fax_media: type: array items: $ref: '#/components/schemas/FaxMedia' description: List of fax media (alias for media). unevaluatedProperties: not: {} description: Response containing a list of fax media. FaxMediaResponse: type: object required: - account_sid - content_type - date_created - date_updated - fax_sid - sid - uri - url properties: account_sid: type: string description: The unique identifier for the account. examples: - b3877c40-da60-4998-90ad-b792e98472ac content_type: type: string description: The content type of the media. examples: - application/pdf date_created: type: string description: The date, in ISO 8601 format, this media was created. examples: - '2018-11-26T20:00:00Z' date_updated: type: string description: The date, in ISO 8601 format, this media was updated. examples: - '2018-11-27T20:00:00Z' fax_sid: type: string description: The unique identifier for the fax. examples: - b3877c40-da60-4998-90ad-b792e98472fx sid: type: string description: The unique identifier for the media. examples: - b3877c40-da60-4998-90ad-b792e98472me uri: type: string description: The URI for the media. examples: - /fax/v1/Faxes/b3877c40-da60-4998-90ad-b792e98472fx/Media/b3877c40-da60-4998-90ad-b792e98472me.json url: type: string description: The URL for the media. examples: - /fax/v1/Faxes/b3877c40-da60-4998-90ad-b792e98472fx/Media/b3877c40-da60-4998-90ad-b792e98472me.json unevaluatedProperties: not: {} description: Response containing a single fax media. FaxQuality: type: string enum: - standard - fine - superfine description: Fax quality. FaxResponse: type: object required: - account_sid - api_version - date_created - date_updated - direction - from - media_url - media_sid - num_pages - price - price_unit - quality - sid - status - to - duration - links - url - error_code - error_message properties: account_sid: type: string description: The unique identifier for the account this fax is associated with. examples: - b3877c40-da60-4998-90ad-b792e98472ac api_version: type: string description: The version of the SignalWire API. examples: - v1 date_created: type: string description: The date and time, in ISO 8601 format, the fax was created. examples: - '2018-11-26T20:00:00Z' date_updated: type: string description: The date and time, in ISO 8601 format, the fax was updated. examples: - '2018-11-27T20:00:00Z' direction: allOf: - $ref: '#/components/schemas/FaxDirection' description: The direction of the fax. from: type: string description: The phone number, in E.164 format, the fax was sent from. examples: - '+13103383454' media_url: anyOf: - type: string - type: 'null' description: The URL hosting the received media, or null if not available. examples: - https://example.com/fax.pdf media_sid: type: string description: The unique identifier for the media instance associated with the fax instance. examples: - b3877c40-da60-4998-90ad-b792e98472me num_pages: anyOf: - type: string - type: 'null' description: The number of pages in the fax document, or null if not yet determined. examples: - '3' price: anyOf: - type: string - type: 'null' description: The cost of the fax, or null if not yet calculated. examples: - '-0.005' price_unit: type: string description: The currency, in ISO 4217 format, of the price. examples: - USD quality: allOf: - $ref: '#/components/schemas/FaxQuality' description: The quality of the fax. sid: type: string description: The unique identifier of the fax. examples: - b3877c40-da60-4998-90ad-b792e98472fx status: allOf: - $ref: '#/components/schemas/FaxStatus' description: The status of the fax. to: type: string description: The phone number, in E.164 format, the fax was sent to. examples: - '+13104456789' duration: type: integer format: int32 description: The time, in seconds, it took to deliver a fax. examples: - 5000 links: allOf: - $ref: '#/components/schemas/FaxLinks' description: The URL links for resources associated with the fax. url: type: string description: The URL of this resource. examples: - /fax/v1/Faxes/b3877c40-da60-4998-90ad-b792e98472fx error_code: anyOf: - type: string - type: 'null' description: Error code for this resource, or null if no error. examples: - null error_message: anyOf: - type: string - type: 'null' description: The description of this error, or null if no error. examples: - null unevaluatedProperties: not: {} description: Response containing a single fax. FaxStatus: type: string enum: - queued - processing - sending - delivered - receiving - received - no-answer - busy - failed - canceled description: Fax status. ImportPhoneNumberRequest: type: object required: - number - number_type properties: number: type: string minLength: 6 maxLength: 31 pattern: ^\+\d{5,30}$ description: The phone number to import in E.164 format. Must start with `+` followed by 5-30 digits. examples: - '+49152234333323' number_type: allOf: - $ref: '#/components/schemas/NumberType' description: The type of phone number being imported. examples: - longcode capabilities: type: array items: $ref: '#/components/schemas/PhoneNumberCapability' minItems: 1 description: The capabilities to enable for this phone number. If not provided, defaults to all capabilities (`sms`, `voice`, `fax`, `mms`). If provided, must include at least one capability. examples: - - sms - voice unevaluatedProperties: not: {} description: Request body for importing a phone number. IncomingPhoneNumber: type: object required: - account_id - account_sid - address_requirements - address_sid - api_version - beta - capabilities - country_code - date_created - date_updated - emergency_address_sid - emergency_status - friendly_name - identity_sid - origin - phone_number - sid - sms_application_sid - sms_fallback_method - sms_fallback_url - sms_method - sms_url - status_callback - status_callback_method - trunk_sid - uri - voice_application_sid - voice_caller_id_lookup - voice_fallback_method - voice_fallback_url - voice_method - voice_url properties: account_id: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that is associated with this phone number. examples: - b3877c40-da60-4998-90ad-b792e98472ac account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that is associated with this phone number. examples: - b3877c40-da60-4998-90ad-b792e98472ac address_requirements: allOf: - $ref: '#/components/schemas/AddressRequirements' description: Whether or not a registered address with SignalWire is required. Always 'none'. address_sid: anyOf: - type: string - type: 'null' description: The unique identifier for the address associated with this phone number. Always null. examples: - null api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' beta: type: boolean description: New numbers on SignalWire are marked as beta. Always false. examples: - false capabilities: allOf: - $ref: '#/components/schemas/IncomingPhoneNumberCapabilities' description: Whether or not a number can receive calls and messages. country_code: type: string description: The ISO 3166-1 alpha-2 country code for this phone number. examples: - US date_created: type: string description: The date, in RFC 2822 format, this phone number was created. examples: - Tue, 25 Sept 2018 23:00:00 +0000 date_updated: type: string description: The date, in RFC 2822 format, this phone number was updated. examples: - Wed, 26 Sept 2018 22:00:00 +0000 emergency_address_sid: anyOf: - type: string - type: 'null' description: The unique identifier of the address associated with E911 for this phone number, or null if not set. examples: - null emergency_status: type: string description: Whether the phone route has an active E911 address associated. 'Active' or 'Inactive'. examples: - Inactive friendly_name: type: string description: A formatted version of the number. examples: - (310) 338-6745 identity_sid: anyOf: - type: string - type: 'null' description: The unique identifier for the identity associated with this phone number. Always null. examples: - null origin: allOf: - $ref: '#/components/schemas/PhoneNumberOrigin' description: The origin of the phone number. phone_number: type: string description: The incoming number in E.164 format. examples: - '+13103386745' sid: type: string description: The unique identifier for this phone number. examples: - b3877c40-da60-4998-90ad-b792e98472pn sms_application_sid: anyOf: - type: string - type: 'null' description: The unique identifier for the application associated with SMS handling on this phone number, or null if not set. examples: - null sms_fallback_method: type: string description: Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. examples: - POST sms_fallback_url: anyOf: - type: string - type: 'null' description: The URL to request if errors occur when fetching SmsUrl, or null if not set. examples: - null sms_method: type: string description: Whether the request to SmsUrl is a `GET` or a `POST`. examples: - POST sms_url: anyOf: - type: string - type: 'null' description: The URL to request when an incoming SMS is received, or null if not set. examples: - null status_callback: anyOf: - type: string - type: 'null' description: The URL to request to pass status updates to, or null if not set. examples: - null status_callback_method: type: string description: Whether the request to StatusCallback is a `GET` or a `POST`. examples: - POST trunk_sid: anyOf: - type: string - type: 'null' description: The unique identifier for the Trunk associated with this phone number. Always null. examples: - null uri: type: string description: The URI for this number. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472ac/IncomingPhoneNumbers/b3877c40-da60-4998-90ad-b792e98472pn.json verification_status: type: string description: The verification status for toll-free numbers. Only present for toll-free numbers. examples: - Unverified voice_application_sid: anyOf: - type: string - type: 'null' description: The unique identifier for the application associated with call handling on this phone number, or null if not set. examples: - null voice_caller_id_lookup: anyOf: - type: boolean - type: 'null' description: Whether or not to look up a caller's name in the database. Always null. examples: - null voice_fallback_method: type: string description: Whether the request to VoiceFallbackUrl is a `GET` or a `POST`. examples: - POST voice_fallback_url: anyOf: - type: string - type: 'null' description: The URL to request if errors occur when fetching `Url`, or null if not set. examples: - null voice_method: type: string description: Whether the request to Url is a `GET` or a `POST`. examples: - POST voice_url: anyOf: - type: string - type: 'null' description: The URL to request when an incoming call is received, or null if not set. examples: - null unevaluatedProperties: not: {} description: Incoming phone number model. IncomingPhoneNumberCapabilities: type: object required: - voice - sms - mms - fax properties: voice: type: boolean description: Whether or not voice is enabled. examples: - true sms: type: boolean description: Whether or not SMS is enabled. examples: - true mms: type: boolean description: Whether or not MMS is enabled. examples: - true fax: type: boolean description: Whether or not fax is enabled. examples: - true unevaluatedProperties: not: {} description: Phone number capabilities. IncomingPhoneNumberListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - incoming_phone_numbers properties: uri: type: string description: The URI of the current page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/IncomingPhoneNumbers?Page=0&PageSize=50 first_page_uri: type: string description: The URI of the first page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/IncomingPhoneNumbers?Page=0&PageSize=50 next_page_uri: anyOf: - type: string - type: 'null' description: The URI of the next page, or null if there are no more pages. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/IncomingPhoneNumbers?Page=1&PageSize=50&PageToken=PAb3877c40da604998 previous_page_uri: anyOf: - type: string - type: 'null' description: The URI of the previous page, or null if this is the first page. examples: - null page: type: integer format: int32 description: The current page number. examples: - 0 page_size: type: integer format: int32 description: The number of items per page. examples: - 50 incoming_phone_numbers: type: array items: $ref: '#/components/schemas/IncomingPhoneNumber' description: List of incoming phone numbers. unevaluatedProperties: not: {} description: Response containing a list of incoming phone numbers. IncomingPhoneNumberResponse: type: object required: - account_id - account_sid - address_requirements - address_sid - api_version - beta - capabilities - country_code - date_created - date_updated - emergency_address_sid - emergency_status - friendly_name - identity_sid - origin - phone_number - sid - sms_application_sid - sms_fallback_method - sms_fallback_url - sms_method - sms_url - status_callback - status_callback_method - trunk_sid - uri - voice_application_sid - voice_caller_id_lookup - voice_fallback_method - voice_fallback_url - voice_method - voice_url properties: account_id: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that is associated with this phone number. examples: - b3877c40-da60-4998-90ad-b792e98472ac account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that is associated with this phone number. examples: - b3877c40-da60-4998-90ad-b792e98472ac address_requirements: allOf: - $ref: '#/components/schemas/AddressRequirements' description: Whether or not a registered address with SignalWire is required. Always 'none'. address_sid: anyOf: - type: string - type: 'null' description: The unique identifier for the address associated with this phone number. Always null. examples: - null api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' beta: type: boolean description: New numbers on SignalWire are marked as beta. Always false. examples: - false capabilities: allOf: - $ref: '#/components/schemas/IncomingPhoneNumberCapabilities' description: Whether or not a number can receive calls and messages. country_code: type: string description: The ISO 3166-1 alpha-2 country code for this phone number. examples: - US date_created: type: string description: The date, in RFC 2822 format, this phone number was created. examples: - Tue, 25 Sept 2018 23:00:00 +0000 date_updated: type: string description: The date, in RFC 2822 format, this phone number was updated. examples: - Wed, 26 Sept 2018 22:00:00 +0000 emergency_address_sid: anyOf: - type: string - type: 'null' description: The unique identifier of the address associated with E911 for this phone number, or null if not set. examples: - null emergency_status: type: string description: Whether the phone route has an active E911 address associated. 'Active' or 'Inactive'. examples: - Inactive friendly_name: type: string description: A formatted version of the number. examples: - (310) 338-6745 identity_sid: anyOf: - type: string - type: 'null' description: The unique identifier for the identity associated with this phone number. Always null. examples: - null origin: allOf: - $ref: '#/components/schemas/PhoneNumberOrigin' description: The origin of the phone number. phone_number: type: string description: The incoming number in E.164 format. examples: - '+13103386745' sid: type: string description: The unique identifier for this phone number. examples: - b3877c40-da60-4998-90ad-b792e98472pn sms_application_sid: anyOf: - type: string - type: 'null' description: The unique identifier for the application associated with SMS handling on this phone number, or null if not set. examples: - null sms_fallback_method: type: string description: Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. examples: - POST sms_fallback_url: anyOf: - type: string - type: 'null' description: The URL to request if errors occur when fetching SmsUrl, or null if not set. examples: - null sms_method: type: string description: Whether the request to SmsUrl is a `GET` or a `POST`. examples: - POST sms_url: anyOf: - type: string - type: 'null' description: The URL to request when an incoming SMS is received, or null if not set. examples: - null status_callback: anyOf: - type: string - type: 'null' description: The URL to request to pass status updates to, or null if not set. examples: - null status_callback_method: type: string description: Whether the request to StatusCallback is a `GET` or a `POST`. examples: - POST trunk_sid: anyOf: - type: string - type: 'null' description: The unique identifier for the Trunk associated with this phone number. Always null. examples: - null uri: type: string description: The URI for this number. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472ac/IncomingPhoneNumbers/b3877c40-da60-4998-90ad-b792e98472pn.json verification_status: type: string description: The verification status for toll-free numbers. Only present for toll-free numbers. examples: - Unverified voice_application_sid: anyOf: - type: string - type: 'null' description: The unique identifier for the application associated with call handling on this phone number, or null if not set. examples: - null voice_caller_id_lookup: anyOf: - type: boolean - type: 'null' description: Whether or not to look up a caller's name in the database. Always null. examples: - null voice_fallback_method: type: string description: Whether the request to VoiceFallbackUrl is a `GET` or a `POST`. examples: - POST voice_fallback_url: anyOf: - type: string - type: 'null' description: The URL to request if errors occur when fetching `Url`, or null if not set. examples: - null voice_method: type: string description: Whether the request to Url is a `GET` or a `POST`. examples: - POST voice_url: anyOf: - type: string - type: 'null' description: The URL to request when an incoming call is received, or null if not set. examples: - null unevaluatedProperties: not: {} description: Response containing a single incoming phone number. Message: type: object required: - account_sid - api_version - body - num_segments - num_media - date_created - date_sent - date_updated - direction - error_code - error_message - from - price - price_unit - sid - status - to - messaging_service_sid - uri - subresource_uris properties: account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier of the project that sent or received this message. examples: - ea108133-d6b3-407c-9536-9fad8a929a6a api_version: type: string description: The version number of the SignalWire cXML REST API used to handle this message. examples: - '2010-04-01' body: anyOf: - type: string - type: 'null' description: The text of the message. Up to 1600 characters long. May be null if filtered for spam. examples: - Hello World! num_segments: type: integer format: int32 description: The number of segments that make up the entire message. examples: - 1 num_media: type: integer format: int32 description: The number of media files that were included with the message. examples: - 1 date_created: type: string description: The date and time the message was created in RFC 2822 format. examples: - Mon, 13 Aug 2018 21:38:46 +0000 date_sent: anyOf: - type: string - type: 'null' description: The date and time the message was sent in RFC 2822 format, or null if not yet sent. examples: - Mon, 13 Aug 2018 21:38:46 +0000 date_updated: type: string description: The date and time the message was last updated in RFC 2822 format. examples: - Mon, 13 Aug 2018 21:38:46 +0000 direction: allOf: - $ref: '#/components/schemas/MessageDirection' description: The direction of the message. error_code: anyOf: - type: string - type: 'null' description: If an error has occurred on the message, the error code will give you a specific code, or null if no error. examples: - '30001' error_message: anyOf: - type: string - type: 'null' description: A human readable description of the error that occurred, or null if no error. examples: - Queue overflow from: type: string description: The phone number in E.164 format that sent the message. examples: - '+15551234567' price: anyOf: - type: number format: float - type: 'null' description: The cost of the individual message billed to your project, or null if not yet calculated. examples: - 0.005 price_unit: type: string description: The currency in which `price` is charged as. examples: - USD sid: allOf: - $ref: '#/components/schemas/uuid' description: A unique ID that identifies this specific message. examples: - 0a059168-ead0-41af-9d1f-343dae832527 status: allOf: - $ref: '#/components/schemas/MessageStatus' description: Current status of the message. to: type: string description: The phone number in E.164 format that received the message. examples: - '+15557654321' messaging_service_sid: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: If a number group was used when sending an outbound message, the number group's ID will be present, or null otherwise. examples: - b3877c40-da60-4998-90ad-b792e98472ms uri: type: string description: The URI of this particular message. examples: - /api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages/0a059168-ead0-41af-9d1f-343dae832527.json subresource_uris: allOf: - $ref: '#/components/schemas/MessageSubresourceUris' description: The URIs for any subresources associated with this message. unevaluatedProperties: not: {} description: Message model. MessageDirection: type: string enum: - inbound - outbound-api - outbound-call - outbound-reply description: Message direction. MessageListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - messages properties: uri: type: string description: The URI of the current page. examples: - /api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages?Page=0&PageSize=50 first_page_uri: type: string description: The URI of the first page. examples: - /api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages?Page=0&PageSize=50 next_page_uri: anyOf: - type: string - type: 'null' description: The URI of the next page, or null if there are no more pages. examples: - /api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages?Page=1&PageSize=50&PageToken=PA0a059168ead041af previous_page_uri: anyOf: - type: string - type: 'null' description: The URI of the previous page, or null if this is the first page. examples: - null page: type: integer format: int32 description: The current page number. examples: - 0 page_size: type: integer format: int32 description: The number of items per page. examples: - 50 messages: type: array items: $ref: '#/components/schemas/Message' description: List of messages. unevaluatedProperties: not: {} description: Response containing a list of messages. MessageMedia: type: object required: - account_sid - content_type - date_created - date_updated - parent_sid - sid - uri properties: account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account. examples: - ea108133-d6b3-407c-9536-9fad8a929a6a content_type: type: string description: The content type of the media. examples: - image/jpeg date_created: type: string description: The date, in RFC 2822 GMT format, this media was created. examples: - Mon, 13 Aug 2018 21:38:46 +0000 date_updated: type: string description: The date, in RFC 2822 GMT format, this media was updated. examples: - Mon, 13 Aug 2018 21:38:46 +0000 parent_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the message. examples: - 0a059168-ead0-41af-9d1f-343dae832527 sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the media. examples: - b3877c40-da60-4998-90ad-b792e98472me uri: type: string description: The URI for the media. examples: - /api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages/0a059168-ead0-41af-9d1f-343dae832527/Media/b3877c40-da60-4998-90ad-b792e98472me.json unevaluatedProperties: not: {} description: Message media model. MessageMediaListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - media_list properties: uri: type: string description: The URI of the current page. examples: - /api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages/0a059168-ead0-41af-9d1f-343dae832527/Media?Page=0&PageSize=50 first_page_uri: type: string description: The URI of the first page. examples: - /api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages/0a059168-ead0-41af-9d1f-343dae832527/Media?Page=0&PageSize=50 next_page_uri: anyOf: - type: string - type: 'null' description: The URI of the next page, or null if there are no more pages. examples: - null previous_page_uri: anyOf: - type: string - type: 'null' description: The URI of the previous page, or null if this is the first page. examples: - null page: type: integer format: int32 description: The current page number. examples: - 0 page_size: type: integer format: int32 description: The number of items per page. examples: - 50 media_list: type: array items: $ref: '#/components/schemas/MessageMedia' description: List of media. unevaluatedProperties: not: {} description: Response containing a list of message media. MessageMediaResponse: type: object required: - account_sid - content_type - date_created - date_updated - parent_sid - sid - uri properties: account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account. examples: - ea108133-d6b3-407c-9536-9fad8a929a6a content_type: type: string description: The content type of the media. examples: - image/jpeg date_created: type: string description: The date, in RFC 2822 GMT format, this media was created. examples: - Mon, 13 Aug 2018 21:38:46 +0000 date_updated: type: string description: The date, in RFC 2822 GMT format, this media was updated. examples: - Mon, 13 Aug 2018 21:38:46 +0000 parent_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the message. examples: - 0a059168-ead0-41af-9d1f-343dae832527 sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the media. examples: - b3877c40-da60-4998-90ad-b792e98472me uri: type: string description: The URI for the media. examples: - /api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages/0a059168-ead0-41af-9d1f-343dae832527/Media/b3877c40-da60-4998-90ad-b792e98472me.json unevaluatedProperties: not: {} description: Response containing a single message media. MessageResponse: type: object required: - account_sid - api_version - body - num_segments - num_media - date_created - date_sent - date_updated - direction - error_code - error_message - from - price - price_unit - sid - status - to - messaging_service_sid - uri - subresource_uris properties: account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier of the project that sent or received this message. examples: - ea108133-d6b3-407c-9536-9fad8a929a6a api_version: type: string description: The version number of the SignalWire cXML REST API used to handle this message. examples: - '2010-04-01' body: anyOf: - type: string - type: 'null' description: The text of the message. Up to 1600 characters long. May be null if filtered for spam. examples: - Hello World! num_segments: type: integer format: int32 description: The number of segments that make up the entire message. examples: - 1 num_media: type: integer format: int32 description: The number of media files that were included with the message. examples: - 1 date_created: type: string description: The date and time the message was created in RFC 2822 format. examples: - Mon, 13 Aug 2018 21:38:46 +0000 date_sent: anyOf: - type: string - type: 'null' description: The date and time the message was sent in RFC 2822 format, or null if not yet sent. examples: - Mon, 13 Aug 2018 21:38:46 +0000 date_updated: type: string description: The date and time the message was last updated in RFC 2822 format. examples: - Mon, 13 Aug 2018 21:38:46 +0000 direction: allOf: - $ref: '#/components/schemas/MessageDirection' description: The direction of the message. error_code: anyOf: - type: string - type: 'null' description: If an error has occurred on the message, the error code will give you a specific code, or null if no error. examples: - '30001' error_message: anyOf: - type: string - type: 'null' description: A human readable description of the error that occurred, or null if no error. examples: - Queue overflow from: type: string description: The phone number in E.164 format that sent the message. examples: - '+15551234567' price: anyOf: - type: number format: float - type: 'null' description: The cost of the individual message billed to your project, or null if not yet calculated. examples: - 0.005 price_unit: type: string description: The currency in which `price` is charged as. examples: - USD sid: allOf: - $ref: '#/components/schemas/uuid' description: A unique ID that identifies this specific message. examples: - 0a059168-ead0-41af-9d1f-343dae832527 status: allOf: - $ref: '#/components/schemas/MessageStatus' description: Current status of the message. to: type: string description: The phone number in E.164 format that received the message. examples: - '+15557654321' messaging_service_sid: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: If a number group was used when sending an outbound message, the number group's ID will be present, or null otherwise. examples: - b3877c40-da60-4998-90ad-b792e98472ms uri: type: string description: The URI of this particular message. examples: - /api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages/0a059168-ead0-41af-9d1f-343dae832527.json subresource_uris: allOf: - $ref: '#/components/schemas/MessageSubresourceUris' description: The URIs for any subresources associated with this message. unevaluatedProperties: not: {} description: Response containing a single message. MessageStatus: type: string enum: - queued - initiated - sent - failed - delivered - undelivered - received description: Message status. MessageSubresourceUris: type: object required: - media properties: media: type: string description: The URI for media. examples: - /api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages/0a059168-ead0-41af-9d1f-343dae832527/Media.json unevaluatedProperties: not: {} description: Message subresource URIs. NumberType: type: string enum: - longcode - tollfree description: The type of phone number being imported. ParticipantStatus: type: string enum: - completed - in-progress description: Conference participant status. PhoneNumberCapabilities: type: object required: - voice - SMS - MMS properties: voice: type: boolean description: Whether or not voice is enabled on the number. examples: - true SMS: type: boolean description: Whether or not SMS is enabled on the number. examples: - true MMS: type: boolean description: Whether or not MMS is enabled on the number. examples: - true unevaluatedProperties: not: {} description: Phone number capabilities. PhoneNumberCapability: type: string enum: - sms - voice - fax - mms description: Phone number capabilities. PhoneNumberOrigin: type: string enum: - signalwire - hosted description: Phone number origin. Queue: type: object required: - sid - account_sid - friendly_name - max_size - current_size - average_wait_time - date_created - date_updated - api_version - uri properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the queue. examples: - b3877c40-da60-4998-90ad-b792e98472qu account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account this Queue is associated with. examples: - b3877c40-da60-4998-90ad-b792e98472af friendly_name: type: string description: A description that distinguishes a queue. examples: - Queue1 max_size: anyOf: - type: integer format: int32 - type: 'null' description: The maximum number of calls that are allowed to wait in a queue. Null if no limit is set. examples: - 100 current_size: type: integer format: int32 minimum: 0 description: The number of calls currently waiting in the queue. examples: - 0 average_wait_time: type: integer format: int32 minimum: 0 description: The average wait time, in seconds, of callers in a queue. examples: - 0 date_created: type: string description: The date and time, in RFC 2822 format, the Queue was created. examples: - Wed, 26 Sep 2018 18:00:00 +0000 date_updated: type: string description: The date and time, in RFC 2822 format, the Queue was updated. examples: - Thu, 27 Sep 2018 19:00:00 +0000 api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' uri: type: string description: The URI of this resource, relative to the API base URL. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Queues/b3877c40-da60-4998-90ad-b792e98472qu.json unevaluatedProperties: not: {} description: Queue model. QueueListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - queues properties: uri: type: string description: The URI of the current page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Queues?Page=0&PageSize=50 first_page_uri: type: string description: The URI of the first page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Queues next_page_uri: anyOf: - type: string - type: 'null' description: The URI of the next page. Null if there are no more pages. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Queues?Page=1&PageSize=50&PageToken=PAb3877c40-da60-4998-90ad-b792e98472qu previous_page_uri: anyOf: - type: string - type: 'null' description: The URI of the previous page. Null if this is the first page. examples: - null page: type: integer format: int32 description: The current page number (zero-indexed). examples: - 0 page_size: type: integer format: int32 description: The number of items per page. examples: - 50 queues: type: array items: $ref: '#/components/schemas/Queue' description: List of queues. unevaluatedProperties: not: {} description: Response containing a list of queues. QueueMember: type: object required: - call_sid - account_sid - queue_sid - date_enqueued - position - wait_time - member_type - uri properties: call_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the call. examples: - b3877c40-da60-4998-90ad-b792e98472ca account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account. examples: - b3877c40-da60-4998-90ad-b792e98472af queue_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the queue. examples: - b3877c40-da60-4998-90ad-b792e98472qu date_enqueued: type: string description: The date and time, in RFC 2822 format, when the member was enqueued. examples: - Wed, 26 Sep 2018 18:00:00 +0000 position: type: integer format: int32 minimum: 1 description: The position of the member in the queue (1-indexed). examples: - 1 wait_time: type: integer format: int32 minimum: 0 description: The wait time, in seconds, since the member was enqueued. examples: - 30 member_type: type: string description: The type of the queue member. examples: - laml_call uri: type: string description: The URI of this resource, relative to the API base URL. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Queues/b3877c40-da60-4998-90ad-b792e98472qu/Members/b3877c40-da60-4998-90ad-b792e98472ca.json unevaluatedProperties: not: {} description: Queue member model representing a call waiting in a queue. QueueMemberListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - queue_members properties: uri: type: string description: The URI of the current page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Queues/b3877c40-da60-4998-90ad-b792e98472qu/Members?Page=0&PageSize=50 first_page_uri: type: string description: The URI of the first page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Queues/b3877c40-da60-4998-90ad-b792e98472qu/Members next_page_uri: anyOf: - type: string - type: 'null' description: The URI of the next page. Null if there are no more pages. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Queues/b3877c40-da60-4998-90ad-b792e98472qu/Members?Page=1&PageSize=50&PageToken=PAb3877c40-da60-4998-90ad-b792e98472me previous_page_uri: anyOf: - type: string - type: 'null' description: The URI of the previous page. Null if this is the first page. examples: - null page: type: integer format: int32 description: The current page number (zero-indexed). examples: - 0 page_size: type: integer format: int32 description: The number of items per page. examples: - 50 queue_members: type: array items: $ref: '#/components/schemas/QueueMember' description: List of queue members. unevaluatedProperties: not: {} description: Response containing a list of queue members. QueueMemberResponse: type: object required: - call_sid - account_sid - queue_sid - date_enqueued - position - wait_time - member_type - uri properties: call_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the call. examples: - b3877c40-da60-4998-90ad-b792e98472ca account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account. examples: - b3877c40-da60-4998-90ad-b792e98472af queue_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the queue. examples: - b3877c40-da60-4998-90ad-b792e98472qu date_enqueued: type: string description: The date and time, in RFC 2822 format, when the member was enqueued. examples: - Wed, 26 Sep 2018 18:00:00 +0000 position: type: integer format: int32 minimum: 1 description: The position of the member in the queue (1-indexed). examples: - 1 wait_time: type: integer format: int32 minimum: 0 description: The wait time, in seconds, since the member was enqueued. examples: - 30 member_type: type: string description: The type of the queue member. examples: - laml_call uri: type: string description: The URI of this resource, relative to the API base URL. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Queues/b3877c40-da60-4998-90ad-b792e98472qu/Members/b3877c40-da60-4998-90ad-b792e98472ca.json unevaluatedProperties: not: {} description: Response containing a single queue member. QueueResponse: type: object required: - sid - account_sid - friendly_name - max_size - current_size - average_wait_time - date_created - date_updated - api_version - uri properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the queue. examples: - b3877c40-da60-4998-90ad-b792e98472qu account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account this Queue is associated with. examples: - b3877c40-da60-4998-90ad-b792e98472af friendly_name: type: string description: A description that distinguishes a queue. examples: - Queue1 max_size: anyOf: - type: integer format: int32 - type: 'null' description: The maximum number of calls that are allowed to wait in a queue. Null if no limit is set. examples: - 100 current_size: type: integer format: int32 minimum: 0 description: The number of calls currently waiting in the queue. examples: - 0 average_wait_time: type: integer format: int32 minimum: 0 description: The average wait time, in seconds, of callers in a queue. examples: - 0 date_created: type: string description: The date and time, in RFC 2822 format, the Queue was created. examples: - Wed, 26 Sep 2018 18:00:00 +0000 date_updated: type: string description: The date and time, in RFC 2822 format, the Queue was updated. examples: - Thu, 27 Sep 2018 19:00:00 +0000 api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' uri: type: string description: The URI of this resource, relative to the API base URL. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Queues/b3877c40-da60-4998-90ad-b792e98472qu.json unevaluatedProperties: not: {} description: Response containing a single queue. Recording: type: object required: - sid - account_sid - api_version - call_sid - conference_sid - channel - channels - date_created - date_updated - start_time - end_time - duration - price - price_unit - source - status - error_code - uri - subresource_uris - encryption_details - trim properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the recording. examples: - 19e436af-5688-4307-b03b-bdb2b42b8142 account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that is associated with this recording. examples: - 720796a0-8ee9-4350-83bd-2d07a3121f1e api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' call_sid: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier for the call that is associated with this recording. Null if this is a conference recording. examples: - 43bb71ee-553f-4074-bb20-8e2747647cce conference_sid: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier for the conference that is associated with this recording. Null if this is a call recording. examples: - null channel: type: string enum: - '1' - '2' description: The number of channels in a recording (singular key). Returns '1' for mono or '2' for stereo. examples: - '1' channels: type: string enum: - '1' - '2' description: The number of channels in a recording. Returns '1' for mono or '2' for stereo. examples: - '1' date_created: type: string description: The date, in RFC 2822 format, this recording was created. examples: - Tue, 25 Sep 2018 23:00:00 +0000 date_updated: type: string description: The date, in RFC 2822 format, this recording was updated. examples: - Wed, 26 Sep 2018 23:00:04 +0000 start_time: anyOf: - type: string - type: 'null' description: The time, in RFC 2822 format, this recording started. examples: - Tue, 25 Sep 2018 23:00:00 +0000 end_time: anyOf: - type: string - type: 'null' description: The time, in RFC 2822 format, this recording ended. examples: - Wed, 26 Sep 2018 23:00:04 +0000 duration: type: integer format: int32 minimum: 0 description: The length, in seconds, of the recording. examples: - 4 price: anyOf: - type: string - type: 'null' description: The cost for the recording. examples: - '-0.0025' price_unit: type: string description: The currency of the price of the recording. examples: - USD source: allOf: - $ref: '#/components/schemas/RecordingSource' description: How the recording was made. status: allOf: - $ref: '#/components/schemas/RecordingStatus' description: The status of the recording. error_code: anyOf: - type: string - type: 'null' description: Further details about a failed recording. examples: - null uri: type: string description: The URI of the recording. examples: - /api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Recordings/19e436af-5688-4307-b03b-bdb2b42b8142.json subresource_uris: allOf: - $ref: '#/components/schemas/RecordingSubresourceUris' description: Subresource URIs. encryption_details: anyOf: - type: string - type: 'null' description: Encryption details. Always null. examples: - null trim: type: string description: Whether leading and trailing silence is trimmed from a recording. examples: - do-not-trim unevaluatedProperties: not: {} description: Recording model. RecordingListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - recordings properties: uri: type: string description: The URI of the current page. examples: - /api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Recordings?Page=0&PageSize=50 first_page_uri: type: string description: The URI of the first page. examples: - /api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Recordings next_page_uri: anyOf: - type: string - type: 'null' description: The URI of the next page. Null if there are no more pages. examples: - /api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Recordings?Page=1&PageSize=50&PageToken=PA19e436af-5688-4307-b03b-bdb2b42b8142 previous_page_uri: anyOf: - type: string - type: 'null' description: The URI of the previous page. Null if this is the first page. examples: - null page: type: integer format: int32 description: The current page number (zero-indexed). examples: - 0 page_size: type: integer format: int32 description: The number of items per page. examples: - 50 recordings: type: array items: $ref: '#/components/schemas/Recording' description: List of recordings. unevaluatedProperties: not: {} description: Response containing a list of recordings. RecordingResponse: type: object required: - sid - account_sid - api_version - call_sid - conference_sid - channel - channels - date_created - date_updated - start_time - end_time - duration - price - price_unit - source - status - error_code - uri - subresource_uris - encryption_details - trim properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the recording. examples: - 19e436af-5688-4307-b03b-bdb2b42b8142 account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that is associated with this recording. examples: - 720796a0-8ee9-4350-83bd-2d07a3121f1e api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' call_sid: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier for the call that is associated with this recording. Null if this is a conference recording. examples: - 43bb71ee-553f-4074-bb20-8e2747647cce conference_sid: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier for the conference that is associated with this recording. Null if this is a call recording. examples: - null channel: type: string enum: - '1' - '2' description: The number of channels in a recording (singular key). Returns '1' for mono or '2' for stereo. examples: - '1' channels: type: string enum: - '1' - '2' description: The number of channels in a recording. Returns '1' for mono or '2' for stereo. examples: - '1' date_created: type: string description: The date, in RFC 2822 format, this recording was created. examples: - Tue, 25 Sep 2018 23:00:00 +0000 date_updated: type: string description: The date, in RFC 2822 format, this recording was updated. examples: - Wed, 26 Sep 2018 23:00:04 +0000 start_time: anyOf: - type: string - type: 'null' description: The time, in RFC 2822 format, this recording started. examples: - Tue, 25 Sep 2018 23:00:00 +0000 end_time: anyOf: - type: string - type: 'null' description: The time, in RFC 2822 format, this recording ended. examples: - Wed, 26 Sep 2018 23:00:04 +0000 duration: type: integer format: int32 minimum: 0 description: The length, in seconds, of the recording. examples: - 4 price: anyOf: - type: string - type: 'null' description: The cost for the recording. examples: - '-0.0025' price_unit: type: string description: The currency of the price of the recording. examples: - USD source: allOf: - $ref: '#/components/schemas/RecordingSource' description: How the recording was made. status: allOf: - $ref: '#/components/schemas/RecordingStatus' description: The status of the recording. error_code: anyOf: - type: string - type: 'null' description: Further details about a failed recording. examples: - null uri: type: string description: The URI of the recording. examples: - /api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Recordings/19e436af-5688-4307-b03b-bdb2b42b8142.json subresource_uris: allOf: - $ref: '#/components/schemas/RecordingSubresourceUris' description: Subresource URIs. encryption_details: anyOf: - type: string - type: 'null' description: Encryption details. Always null. examples: - null trim: type: string description: Whether leading and trailing silence is trimmed from a recording. examples: - do-not-trim unevaluatedProperties: not: {} description: Response containing a single recording. RecordingSource: type: string enum: - DialVerb - Conference - OutBoundApi - Trunking - RecordVerb - StartCallRecordingApi - StartConferenceRecording description: Recording source. RecordingStatus: type: string enum: - queued - in-progress - paused - resumed - completed - absent - stopped description: Recording status. RecordingSubresourceUris: type: object required: - transcriptions properties: transcriptions: type: string description: The URI for transcriptions. examples: - /api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Recordings/19e436af-5688-4307-b03b-bdb2b42b8142/Transcriptions.json unevaluatedProperties: not: {} description: Recording subresource URIs. SendFaxRequest: type: object required: - MediaUrl - To - From properties: MediaUrl: type: string description: The URL hosting the fax media to send. examples: - https://example.com/fax.pdf To: type: string description: The phone number, in E.164 format, or SIP URI the fax will be sent to. examples: - '+13104456789' From: type: string description: The phone number, in E.164 format, or client identifier the fax will be sent from. examples: - '+13103383454' Quality: type: string enum: - standard - fine - superfine description: The quality of the fax. Default is 'fine'. examples: - fine default: fine StatusCallback: type: string description: The URL to send status callback requests to when the fax status changes. examples: - https://your-api-endpoint.com/fax-status StatusCallbackMethod: type: string enum: - GET - POST description: The HTTP method to use for status callback requests. Default is 'POST'. examples: - POST default: POST StatusCallbackEvent: type: array items: type: string description: "The events that trigger status callback requests. Valid values: 'initiated', 'ringing', 'answered', 'completed', 'ringing_forwarded', 'ringing_queued'. Default is ['completed']." examples: - - completed StoreMedia: type: string enum: - 'true' - 'false' description: Whether to store the fax media. Default is 'true'. examples: - 'true' default: 'true' Ttl: type: integer format: int32 minimum: 5 maximum: 300 description: Time to live in minutes for the fax. Must be between 5 and 300. Default is 60. examples: - 60 default: 60 SipAuthUsername: type: string description: The username for SIP authentication. examples: - user123 SipAuthPassword: type: string description: The password for SIP authentication. examples: - password123 unevaluatedProperties: not: {} description: Request body for sending a fax. StreamStatus: type: string enum: - queued - in-progress - stopped description: Stream status. SubresourceUris: type: object required: - addresses - available_phone_numbers - applications - authorized_connect_apps - calls - conferences - connect_apps - incoming_phone_numbers - keys - notifications - outgoing_caller_ids - queues - recordings - sandbox - sip - short_codes - messages - transcriptions - usage properties: addresses: type: 'null' description: URI for addresses. Not supported. examples: - null available_phone_numbers: type: string description: URI for available phone numbers. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/AvailablePhoneNumbers applications: type: string description: URI for applications. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Applications authorized_connect_apps: type: 'null' description: URI for authorized connect apps. Not supported. examples: - null calls: type: string description: URI for calls. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls conferences: type: string description: URI for conferences. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences connect_apps: type: 'null' description: URI for connect apps. Not supported. examples: - null incoming_phone_numbers: type: string description: URI for incoming phone numbers. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/IncomingPhoneNumbers keys: type: 'null' description: URI for keys. Not supported. examples: - null notifications: type: 'null' description: URI for notifications. Not supported. examples: - null outgoing_caller_ids: type: 'null' description: URI for outgoing caller IDs. Not supported. examples: - null queues: type: string description: URI for queues. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Queues recordings: type: string description: URI for recordings. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Recordings sandbox: type: 'null' description: URI for sandbox. Not supported. examples: - null sip: type: 'null' description: URI for SIP. Not supported. examples: - null short_codes: type: 'null' description: URI for short codes. Not supported. examples: - null messages: type: string description: URI for messages. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Messages transcriptions: type: string description: URI for transcriptions. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Transcriptions usage: type: 'null' description: URI for usage. Not supported. examples: - null unevaluatedProperties: not: {} description: A Map of sub-resources that are linked to the given Project. TokenResponse: type: object required: - id - name - permissions - token properties: id: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier of the created API Token. examples: - ea14556a-984f-11ee-b9d1-0242ac120002 name: type: string minLength: 1 description: The name of the created API Token. examples: - John Doe's Token permissions: type: array items: type: string description: The permissions enabled for this token. examples: - - calling - fax - messaging token: type: string description: The API token that can be used along with the project ID for basic authentication. examples: - PT037258e533e87ac63174ee136ed0798dc85d4f4f9e6d7191 unevaluatedProperties: not: {} description: Response containing a single token. Transcription: type: object required: - sid - account_sid - api_version - recording_sid - date_created - date_updated - duration - price - price_unit - status - transcription_text - type - uri properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the transcription. examples: - b3877c40-da60-4998-90ad-b792e98472tr account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that created this transcription. examples: - b3877c40-da60-4998-90ad-b792e98472ac api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' recording_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the recording that this transcription was created from. examples: - b3877c40-da60-4998-90ad-b792e98472re date_created: type: string description: The date, in RFC 2822 format, this transcription was created. examples: - Thu, 27 Sep 2018 02:00:00 +0000 date_updated: type: string description: The date, in RFC 2822 format, this transcription was updated. examples: - Fri, 28 Sep 2018 03:00:00 +0000 duration: type: integer format: int32 minimum: 0 description: The duration, in seconds, of the transcribed audio. examples: - 60 price: anyOf: - type: string - type: 'null' description: The charge for the transcription. Null if cost has not been calculated. examples: - '-0.00025' price_unit: type: string description: The currency, in ISO 4217 format, for the price of the transcription. examples: - USD status: type: string description: The status of the transcription. Always 'completed' for transcriptions returned by the API. examples: - completed transcription_text: anyOf: - type: string - type: 'null' description: The text content of the transcription. Null if transcription text is not available. examples: - Hello, this is a test transcription. type: type: string description: The type of the transcription. Currently always an empty string. examples: - '' uri: type: string description: The URI of this resource, relative to the API base URL. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472ac/Transcriptions/b3877c40-da60-4998-90ad-b792e98472tr.json unevaluatedProperties: not: {} description: Transcription model. TranscriptionListResponse: type: object required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - transcriptions properties: uri: type: string description: The URI of the current page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472ac/Transcriptions?Page=0&PageSize=50 first_page_uri: type: string description: The URI of the first page. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472ac/Transcriptions next_page_uri: anyOf: - type: string - type: 'null' description: The URI of the next page. Null if there are no more pages. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472ac/Transcriptions?Page=1&PageSize=50&PageToken=PAb3877c40-da60-4998-90ad-b792e98472tr previous_page_uri: anyOf: - type: string - type: 'null' description: The URI of the previous page. Null if this is the first page. examples: - null page: type: integer format: int32 description: The current page number (zero-indexed). examples: - 0 page_size: type: integer format: int32 description: The number of items per page. examples: - 50 transcriptions: type: array items: $ref: '#/components/schemas/Transcription' description: List of transcriptions. unevaluatedProperties: not: {} description: Response containing a list of transcriptions. TranscriptionResponse: type: object required: - sid - account_sid - api_version - recording_sid - date_created - date_updated - duration - price - price_unit - status - transcription_text - type - uri properties: sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the transcription. examples: - b3877c40-da60-4998-90ad-b792e98472tr account_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the account that created this transcription. examples: - b3877c40-da60-4998-90ad-b792e98472ac api_version: type: string description: The version of the SignalWire API. examples: - '2010-04-01' recording_sid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the recording that this transcription was created from. examples: - b3877c40-da60-4998-90ad-b792e98472re date_created: type: string description: The date, in RFC 2822 format, this transcription was created. examples: - Thu, 27 Sep 2018 02:00:00 +0000 date_updated: type: string description: The date, in RFC 2822 format, this transcription was updated. examples: - Fri, 28 Sep 2018 03:00:00 +0000 duration: type: integer format: int32 minimum: 0 description: The duration, in seconds, of the transcribed audio. examples: - 60 price: anyOf: - type: string - type: 'null' description: The charge for the transcription. Null if cost has not been calculated. examples: - '-0.00025' price_unit: type: string description: The currency, in ISO 4217 format, for the price of the transcription. examples: - USD status: type: string description: The status of the transcription. Always 'completed' for transcriptions returned by the API. examples: - completed transcription_text: anyOf: - type: string - type: 'null' description: The text content of the transcription. Null if transcription text is not available. examples: - Hello, this is a test transcription. type: type: string description: The type of the transcription. Currently always an empty string. examples: - '' uri: type: string description: The URI of this resource, relative to the API base URL. examples: - /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472ac/Transcriptions/b3877c40-da60-4998-90ad-b792e98472tr.json unevaluatedProperties: not: {} description: Response containing a single transcription. UpdateAccountRequest: type: object required: - FriendlyName properties: FriendlyName: type: string maxLength: 250 description: The new name for the Project. examples: - My Project unevaluatedProperties: not: {} description: Request body for updating an account. UpdateApplicationRequest: type: object required: - FriendlyName properties: FriendlyName: type: string maxLength: 64 description: A named unique identifier for the resource. examples: - My Friendly Name VoiceUrl: type: string format: uri description: The URL to request when a phone number receives a call or fax. examples: - http://example.com VoiceMethod: type: string enum: - GET - POST description: Whether the request to `VoiceUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST VoiceFallbackUrl: type: string format: uri description: The URL SignalWire will request if errors occur when fetching the `VoiceUrl`. examples: - http://example.com VoiceFallbackMethod: type: string enum: - GET - POST description: Whether the request to `VoiceFallbackUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST StatusCallback: type: string format: uri description: The URL to pass status updates to the Application. examples: - http://example.com StatusCallbackMethod: type: string enum: - GET - POST description: Whether the request to the `StatusCallback` URL is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST SmsUrl: type: string format: uri description: The URL to request when an SMS is received. examples: - http://example.com SmsMethod: type: string enum: - GET - POST description: Whether the request to `SmsUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST SmsFallbackUrl: type: string format: uri description: The URL SignalWire will request if errors occur when fetching the `SmsUrl`. examples: - http://www.example.com/sms-fallback SmsFallbackMethod: type: string enum: - GET - POST description: Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST SmsStatusCallback: type: string format: uri description: The URL to receive status updates for messages sent via this Application. examples: - http://www.example.com/sms-status-callback SmsStatusCallbackMethod: type: string enum: - GET - POST description: Whether the request to `SmsStatusCallback` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST unevaluatedProperties: not: {} description: Request body for updating an application. UpdateCallRecordingRequest: type: object required: - Status properties: Status: type: string enum: - paused - in-progress - stopped description: The status of the recording. examples: - paused PauseBehavior: type: string enum: - skip - silence description: What to do while recording is paused. Default is `silence`. examples: - silence default: silence unevaluatedProperties: not: {} description: Request body for updating a call recording. UpdateCallRequest: type: object properties: Url: type: string format: uri description: The URL to handle the call. examples: - http://your-application.com/docs/voice.xml Method: type: string enum: - GET - POST description: Whether the request to `Url` is a `GET` or a `POST`. examples: - POST Status: type: string enum: - canceled - completed description: The status to update the call to. examples: - completed FallbackUrl: type: string format: uri description: The URL SignalWire will request if errors occur. examples: - https://your-api-endpoint.com/fallback FallbackMethod: type: string enum: - GET - POST description: Whether the request to `FallbackUrl` is a `GET` or a `POST`. examples: - POST StatusCallback: type: string format: uri description: The URL SignalWire will send webhooks to. examples: - https://your-api-endpoint.com/status StatusCallbackMethod: type: string enum: - GET - POST description: Whether the request to `StatusCallback` is a `GET` or a `POST`. examples: - POST unevaluatedProperties: not: {} description: Request body for updating a call. UpdateCallStreamRequest: type: object required: - Status properties: Status: type: string enum: - stopped description: The status of the stream. Only 'stopped' is allowed. examples: - stopped unevaluatedProperties: not: {} description: Request body for updating a call stream. UpdateConferenceParticipantRequest: type: object properties: AnnounceUrl: type: string format: uri description: The URL to send conference announcements to. examples: - https://your-api-endpoint.com/announce AnnounceMethod: type: string enum: - GET - POST description: Whether the request to `AnnounceUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST Coaching: type: boolean description: Whether the participant is coaching another call. Requires `CallSidToCoach` to be set. examples: - false CallSidToCoach: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier of the participant who is being coached. Required when `Coaching` is true. examples: - b3877c40-da60-4998-90ad-b792e98472co Hold: type: boolean description: Whether or not a participant is on hold. examples: - false HoldMethod: type: string enum: - GET - POST description: Whether the request to `HoldUrl` is a `GET` or a `POST`. Default is `GET`. examples: - GET default: GET HoldUrl: type: string format: uri description: The URL to send hold music to that will be played when participant is on hold. examples: - https://your-api-endpoint.com/hold-music Muted: type: boolean description: Whether or not a participant is muted. examples: - false WaitUrl: type: string format: uri description: The URL for wait music to be played while a conference is not yet started. examples: - https://your-api-endpoint.com/wait-music WaitMethod: type: string enum: - GET - POST description: Whether the request to `WaitUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST unevaluatedProperties: not: {} description: Request body for updating a conference participant. UpdateConferenceRecordingRequest: type: object required: - Status properties: Status: type: string enum: - paused - in-progress - stopped description: The status of the recording. examples: - paused PauseBehavior: type: string enum: - skip - silence description: What to do while recording is paused. Default is `silence`. examples: - silence default: silence unevaluatedProperties: not: {} description: Request body for updating a conference recording. UpdateConferenceRequest: type: object properties: Status: type: string enum: - completed description: The status of this conference. Only 'completed' is allowed to end the conference. examples: - completed AnnounceUrl: type: string format: uri description: The URL to send conference announcements to. examples: - https://your-api-endpoint.com/announce AnnounceMethod: type: string enum: - GET - POST description: Whether the request to `AnnounceUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST unevaluatedProperties: not: {} description: Request body for updating a conference. UpdateConferenceStreamRequest: type: object required: - Status properties: Status: type: string enum: - stopped description: The status of the stream. Only 'stopped' is allowed. examples: - stopped unevaluatedProperties: not: {} description: Request body for updating a conference stream. UpdateCxmlScriptRequest: type: object required: - Name properties: Name: type: string minLength: 1 description: A friendly name given to the cXML script. Required. examples: - Death Star IVR Contents: type: string description: The cXML contents of the script. Must be valid XML with proper Mustache syntax if templates are used. examples: - Hello! unevaluatedProperties: not: {} description: Request body for updating a cXML script. UpdateFaxRequest: type: object required: - Status properties: Status: type: string enum: - canceled description: The status to set. Only 'canceled' is allowed. The fax must be in 'queued' status to be canceled. examples: - canceled unevaluatedProperties: not: {} description: Request body for updating (canceling) a fax. UpdateIncomingPhoneNumberRequest: type: object properties: AccountSid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for an account to which the number should be transferred. Must be within the same Space. examples: - b3877c40-da60-4998-90ad-b792e98472ac EmergencyAddressSid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier of the address associated with E911 for this phone number. Not supported for toll-free numbers or certain providers. examples: - b3877c40-da60-4998-90ad-b792e98472ad FriendlyName: type: string minLength: 1 maxLength: 255 description: A friendly name for the phone number. examples: - My Business Line SmsApplicationSid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the application associated with SMS handling on this phone number. examples: - b3877c40-da60-4998-90ad-b792e98472sa SmsFallbackMethod: type: string enum: - GET - POST description: Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST SmsFallbackUrl: type: string format: uri description: The URL to request if errors occur when fetching SmsUrl. examples: - https://example.com/sms-fallback SmsMethod: type: string enum: - GET - POST description: Whether the request to SmsUrl is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST SmsUrl: type: string format: uri description: The URL to request when an incoming SMS is received. examples: - https://example.com/sms StatusCallback: type: string format: uri description: The URL to request to pass status updates to. examples: - https://example.com/status StatusCallbackMethod: type: string enum: - GET - POST description: Whether the request to StatusCallback is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST VoiceApplicationSid: allOf: - $ref: '#/components/schemas/uuid' description: The unique identifier for the application associated with call handling on this phone number. examples: - b3877c40-da60-4998-90ad-b792e98472va VoiceFallbackMethod: type: string enum: - GET - POST description: Whether the request to VoiceFallbackUrl is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST VoiceFallbackUrl: type: string format: uri description: The URL to request if errors occur when fetching VoiceUrl. examples: - https://example.com/voice-fallback VoiceMethod: type: string enum: - GET - POST description: Whether the request to VoiceUrl is a `GET` or a `POST`. Default is `POST`. examples: - POST default: POST VoiceReceiveMode: type: string enum: - voice - fax description: Whether this number can receive voice calls or faxes. examples: - voice VoiceUrl: type: string format: uri description: The URL to request when an incoming call is received. examples: - https://example.com/voice unevaluatedProperties: not: {} description: Request body for updating an incoming phone number. UpdateMessageRequest: type: object required: - Body properties: Body: type: string maxLength: 0 description: The new body of the message. Must be an empty string to redact the message content. examples: - '' unevaluatedProperties: not: {} description: Request body for updating (redacting) a message. UpdateQueueMemberRequest: type: object required: - Url properties: Url: type: string format: uri description: The URL to redirect the dequeued member to. This URL should return cXML instructions for handling the call. examples: - https://your-application.com/dequeue-handler Method: type: string enum: - GET - POST description: The HTTP method to use when requesting the URL. Default is `POST`. examples: - POST default: POST unevaluatedProperties: not: {} description: Request body for dequeuing a queue member. UpdateQueueRequest: type: object required: - FriendlyName properties: FriendlyName: type: string minLength: 1 pattern: ^\w+$ description: A unique name for the queue. Must contain only alphanumeric characters and underscores. examples: - Queue1 MaxSize: type: integer format: int32 description: The maximum number of calls that are allowed to wait in a queue. Must be a positive integer. exclusiveMinimum: 0 examples: - 100 unevaluatedProperties: not: {} description: Request body for updating a queue. UpdateTokenRequest: type: object properties: name: type: string minLength: 1 description: The name representing the project API token. examples: - John Doe's Token permissions: type: array items: type: string description: 'The permissions you would like to enable for this project API token. If not provided, existing permissions are kept. Valid permissions are: calling, chat, datasphere, fax, management, messaging, numbers, pubsub, storage, tasking, and video.' examples: - - calling - fax - messaging unevaluatedProperties: not: {} description: Request body for updating an API token. uuid: type: string format: uuid description: Universal Unique Identifier. securitySchemes: SignalWireBasicAuth: type: http scheme: Basic description: |- SignalWire Basic Authentication using Project ID and API Token. The client sends HTTP requests with the Authorization header containing the word Basic followed by a space and a base64-encoded string of project_id:token. The project ID will be used as the username and the API token as the password. Example: ``` Authorization: Basic base64(project_id:token) ``` x-fern-basic: username: name: project_id env: SIGNALWIRE_PROJECT_ID password: name: api_token env: SIGNALWIRE_API_TOKEN servers: - url: https://{space_name}.signalwire.com/api/laml/2010-04-01 description: SignalWire Compatibility API variables: space_name: default: YOUR_SPACE description: Your SignalWire Space name webhooks: transcriptionStatusCallback: post: operationId: transcription_status_callback summary: Transcription status callback requestBody: required: true content: application/json: schema: type: object properties: TranscriptionSid: type: string description: The unique, 34-character ID of the transcription. example: b3877c40-da60-4998-90ad-b792e984tr01 TranscriptionText: type: string description: The text of the transcription. example: Hello, I'd like to schedule an appointment for next Tuesday. TranscriptionStatus: type: string enum: - completed - failed description: The status of the transcription. example: completed TranscriptionUrl: type: string description: The URL for the transcription's REST API resource. example: https://example.signalwire.com/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Transcriptions/b3877c40-da60-4998-90ad-b792e984tr01 RecordingSid: type: string description: The unique, 34-character identifier for the recording from which the transcription was generated. example: b3877c40-da60-4998-90ad-b792e984re01 RecordingUrl: type: string description: The URL for the audio recording from which the transcription was generated. example: https://example.signalwire.com/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Recordings/b3877c40-da60-4998-90ad-b792e984re01 required: - TranscriptionSid - TranscriptionText - TranscriptionStatus - TranscriptionUrl - RecordingSid - RecordingUrl unevaluatedProperties: not: {} description: |- Payload sent by SignalWire to your Transcription Status Callback URL when the status of a transcription changes. Configure this callback by enabling transcription on a recording via the [Record](/docs/compatibility-api/cxml/reference/voice/record) verb (`transcribe=true`) and setting `transcribeCallback` to your webhook URL. Your app can use these parameters to handle the transcription — for example, uploading the text to your CRM, sending it via email, or forwarding the body via SignalWire SMS. responses: '200': description: Webhook received description: |- Payload sent by SignalWire to your Transcription Status Callback URL when the status of a transcription changes. Configure this callback by enabling transcription on a recording via the [Record](/docs/compatibility-api/cxml/reference/voice/record) verb (`transcribe=true`) and setting `transcribeCallback` to your webhook URL. Your app can use these parameters to handle the transcription — for example, uploading the text to your CRM, sending it via email, or forwarding the body via SignalWire SMS. tags: - Recording Transcriptions voiceStatusCallback: post: operationId: voice_status_callback summary: Voice status callback requestBody: required: true content: application/json: schema: type: object properties: AccountSid: type: string description: The unique ID of the project this call is associated with. example: b3877c40-da60-4998-90ad-b792e98472af ApiVersion: type: string description: |- The version of the SignalWire API. Incoming calls use the API version placed on the number called. Outgoing calls use the version of the REST API request. example: '2010-04-01' AudioInAveragePtime: type: integer format: int32 description: The average time between packets for the inbound stream. example: 20 AudioInDtmfPacketCount: type: integer format: int32 description: The number of DTMF packets in the inbound media stream. example: 0 AudioInFlushPacketCount: type: integer format: int32 description: |- The number of incoming packets removed from the jitter buffer due to buffer overflow or underflow, causing these packets to be discarded or lost. example: 2 AudioInJitterMaxVariance: type: integer format: int32 description: The maximum variance of jitter for incoming audio RTP packets. example: 8 AudioInJitterMinVariance: type: integer format: int32 description: The minimum variance of jitter for incoming audio RTP packets. example: 1 AudioInLargestJbSize: type: integer format: int32 description: The largest jitter buffer size recorded for incoming audio RTP packets during the session. example: 4 AudioInMos: type: string description: A mean opinion score on a scale of 1–5 that helps determine audio quality. example: '4.3' AudioInMediaPacketCount: type: integer format: int32 description: The number of audio packets received in the inbound media stream. example: 1842 AudioInSkipPacketCount: type: integer format: int32 description: |- Increased with every packet not received at a given ptime. Increases with every lost packet from the inbound stream. example: 1 AudioOutDtmfPacketCount: type: integer format: int32 description: The total number of DTMF packets generated in the outbound media stream. example: 0 AudioOutMediaPacketCount: type: integer format: int32 description: The number of audio packets sent in the outbound media stream. example: 1840 CallbackSource: type: string description: The source of the status callback. example: call-progress-events CallDuration: type: integer format: int32 description: The duration, in seconds, of the finished call. Only present on the `completed` event. example: 94 CallerName: type: string description: The name of the caller. Only available if Caller ID lookup is enabled. example: Jane Smith CallSid: type: string description: A unique identifier for the call. example: b3877c40-da60-4998-90ad-b792e98472ca CallStatus: type: string enum: - initiated - ringing - in-progress - queued - failed - busy - no-answer - completed - canceled description: |- The status of the call. | Status | Description | |--------|-------------| | `initiated` | The initial dial has begun. | | `ringing` | The call is ringing. | | `in-progress` | The call was answered and is in progress. | | `queued` | The call is ready and in line to initiate. | | `failed` | The call could not be completed. Usually occurs when the phone number does not exist. | | `busy` | The caller encountered a busy signal. | | `no-answer` | The call ended without an answer. | | `completed` | The call was answered and ended normally. | | `canceled` | The REST API canceled the call while it was ringing or queued. | example: completed Direction: type: string enum: - outbound-dial - outbound-api - inbound description: |- The direction of the call. - `outbound-dial`: calls launched through the Dial verb. - `outbound-api`: calls launched through the REST API. - `inbound`: inbound calls. example: outbound-api ForwardedFrom: type: string description: The number this call was forwarded from. example: '+15550001111' From: type: string description: The phone number that sent this call, in E.164 format. example: '+15551234567' ParentCallSid: type: string description: A unique identifier for the call that created this call. example: b3877c40-da60-4998-90ad-b792e98472pa RecordingDuration: type: integer format: int32 description: The duration, in seconds, of the recording. example: 94 RecordingSid: type: string description: The unique identifier for the audio recording. example: b3877c40-da60-4998-90ad-b792e984re01 RecordingUrl: type: string description: The URL of the recorded audio call. example: https://example.signalwire.com/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Recordings/b3877c40-da60-4998-90ad-b792e984re01 SequenceNumber: type: integer format: int32 description: |- The order in which events occur, starting at 0. Although events are fired in order, they each take time and may not appear in the order you expect. example: 4 SipInviteResultPhrase: type: string description: A textual description of the result of the SIP INVITE request, indicating success or failure with additional details. example: OK SipResultCode: type: string description: The numeric SIP response code received for the INVITE request, indicating the outcome of the call attempt. See the [list of SIP response codes](https://en.wikipedia.org/wiki/List_of_SIP_response_codes) for possible values. example: '200' Timestamp: type: string description: The timestamp, in RFC 2822 format, of when the event occurred. example: Thu, 04 Apr 2024 18:32:15 +0000 To: type: string description: The phone number of the call recipient, in E.164 format. example: '+15559876543' required: - AccountSid - ApiVersion - AudioInAveragePtime - AudioInDtmfPacketCount - AudioInFlushPacketCount - AudioInJitterMaxVariance - AudioInJitterMinVariance - AudioInLargestJbSize - AudioInMos - AudioInMediaPacketCount - AudioInSkipPacketCount - AudioOutDtmfPacketCount - AudioOutMediaPacketCount - CallbackSource - CallSid - CallStatus - Direction - From - SequenceNumber - Timestamp - To unevaluatedProperties: not: {} description: |- Payload sent by SignalWire to your Voice Status Callback URL when the status of a call changes. Configure this callback using the `StatusCallback` and `StatusCallbackEvent` parameters when [creating a call via the API](/docs/compatibility-api/rest/calls/create-a-call) or using [Dial](/docs/compatibility-api/cxml/reference/voice/dial) with [Number](/docs/compatibility-api/cxml/reference/voice/number), [SIP](/docs/compatibility-api/cxml/reference/voice/sip), or [Conference](/docs/compatibility-api/cxml/reference/voice/conference). Use `StatusCallbackEvent` to receive every call progress event — not just the final status — along with current call state and all parameters below. responses: '200': description: Webhook received description: |- Payload sent by SignalWire to your Voice Status Callback URL when the status of a call changes. Configure this callback using the `StatusCallback` and `StatusCallbackEvent` parameters when [creating a call via the API](/docs/compatibility-api/rest/calls/create-a-call) or using [Dial](/docs/compatibility-api/cxml/reference/voice/dial) with [Number](/docs/compatibility-api/cxml/reference/voice/number), [SIP](/docs/compatibility-api/cxml/reference/voice/sip), or [Conference](/docs/compatibility-api/cxml/reference/voice/conference). Use `StatusCallbackEvent` to receive every call progress event — not just the final status — along with current call state and all parameters below. tags: - Calls recordingStatusCallback: post: operationId: recording_status_callback summary: Recording status callback requestBody: required: true content: application/json: schema: type: object properties: AccountSid: type: string description: The unique ID of the project this call is associated with. example: b3877c40-da60-4998-90ad-b792e98472af CallSid: type: string description: A unique identifier for the call. May be used to later retrieve this call from the REST API. example: b3877c40-da60-4998-90ad-b792e98472ca RecordingSid: type: string description: The unique identifier for the recording. example: b3877c40-da60-4998-90ad-b792e984re01 RecordingUrl: type: string description: The URL for the audio recording. example: https://example.signalwire.com/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Recordings/b3877c40-da60-4998-90ad-b792e984re01 RecordingStatus: type: string enum: - in-progress - completed - absent description: |- The status of the recording. - `in-progress`: Recording has begun. - `completed`: File is available. - `absent`: Recording was too short or no audio was detected. example: completed RecordingDuration: type: integer format: int32 description: The duration, in seconds, of the recording. example: 94 RecordingChannels: type: integer format: int32 description: The number of channels in the recording. example: 1 RecordingSource: type: string description: The type of call that initiated the recording. example: RecordVerb required: - AccountSid - CallSid - RecordingSid - RecordingUrl - RecordingStatus - RecordingDuration - RecordingChannels - RecordingSource unevaluatedProperties: not: {} description: |- Payload sent by SignalWire to your `RecordingStatusCallback` URL when a recording status event occurs. Recordings are not always available immediately — especially at high call volumes. This callback lets your app react as soon as a recording is ready, whether that means uploading it to external storage, sending it via email, or forwarding the URL via SMS. Configure `RecordingStatusCallback` when [creating a call via the API](/docs/compatibility-api/rest/calls/create-a-call) or when using [Dial](/docs/compatibility-api/cxml/reference/voice/dial), [Conference](/docs/compatibility-api/cxml/reference/voice/conference), or [Record](/docs/compatibility-api/cxml/reference/voice/record). Use `RecordingStatusCallbackEvent` to request callbacks for specific events. If omitted, only the `completed` event is sent. Possible values: `in-progress`, `completed`, `absent`. | Status | Description | |--------|-------------| | `in-progress` | The recording has begun. | | `completed` | The file is available for access. | | `absent` | The recording was too short or the call was silent — no audio was detected. | responses: '200': description: Webhook received description: |- Payload sent by SignalWire to your `RecordingStatusCallback` URL when a recording status event occurs. Recordings are not always available immediately — especially at high call volumes. This callback lets your app react as soon as a recording is ready, whether that means uploading it to external storage, sending it via email, or forwarding the URL via SMS. Configure `RecordingStatusCallback` when [creating a call via the API](/docs/compatibility-api/rest/calls/create-a-call) or when using [Dial](/docs/compatibility-api/cxml/reference/voice/dial), [Conference](/docs/compatibility-api/cxml/reference/voice/conference), or [Record](/docs/compatibility-api/cxml/reference/voice/record). Use `RecordingStatusCallbackEvent` to request callbacks for specific events. If omitted, only the `completed` event is sent. Possible values: `in-progress`, `completed`, `absent`. | Status | Description | |--------|-------------| | `in-progress` | The recording has begun. | | `completed` | The file is available for access. | | `absent` | The recording was too short or the call was silent — no audio was detected. | tags: - Recordings incomingCallStatusCallback: post: operationId: incoming_call_status_callback summary: Incoming call status callback requestBody: required: true content: application/json: schema: type: object properties: CallSid: type: string description: A unique identifier for the call. May be used to later retrieve this call from the REST API. example: b3877c40-da60-4998-90ad-b792e98472ca AccountSid: type: string description: The unique ID of the project this call is associated with. example: b3877c40-da60-4998-90ad-b792e98472af From: type: string description: The From number in E.164 format. example: '+15551234567' To: type: string description: The To number in E.164 format. example: '+18005559876' Timestamp: type: string description: The timestamp of the call creation date/time. example: Thu, 04 Apr 2024 18:32:15 +0000 CallStatus: type: string enum: - failed - completed description: The status of the call. For this callback, the value will be either `failed` or `completed`. example: completed CallDuration: type: string description: The duration, in seconds, of the call. example: '142' AudioInMos: type: string description: A mean opinion score on a scale of 1–5 that represents the quality of the call. example: '4.5' required: - CallSid - AccountSid - From - To - Timestamp - CallStatus - CallDuration - AudioInMos unevaluatedProperties: not: {} description: |- Payload sent by SignalWire to your Inbound Call Status Callback URL for inbound calls to a phone number. Configure `StatusCallback` at the phone number level via the dashboard (**Phone Numbers** → select a number → **Phone Number Settings**) or programmatically via the [create](/docs/compatibility-api/rest/incoming-phone-numbers/create-incoming-phone-number) or [update](/docs/compatibility-api/rest/incoming-phone-numbers/update-incoming-phone-number) Incoming Phone Number API endpoints. By default, the webhook fires only when the call is `completed` or `failed`, making it well-suited for tracking inbound call success rate, call quality, and total call volume in a call center context. responses: '200': description: Webhook received description: |- Payload sent by SignalWire to your Inbound Call Status Callback URL for inbound calls to a phone number. Configure `StatusCallback` at the phone number level via the dashboard (**Phone Numbers** → select a number → **Phone Number Settings**) or programmatically via the [create](/docs/compatibility-api/rest/incoming-phone-numbers/create-incoming-phone-number) or [update](/docs/compatibility-api/rest/incoming-phone-numbers/update-incoming-phone-number) Incoming Phone Number API endpoints. By default, the webhook fires only when the call is `completed` or `failed`, making it well-suited for tracking inbound call success rate, call quality, and total call volume in a call center context. tags: - Incoming Phone Numbers smsStatusCallback: post: operationId: sms_status_callback summary: SMS status callback requestBody: required: true content: application/json: schema: type: object properties: MessageStatus: type: string enum: - queued - sending - sent - delivered - undelivered - failed - receiving - received description: |- The current status of the message at the time of the callback. One of: `queued`, `sending`, `sent`, `delivered`, `undelivered`, `failed`, `receiving`, `received`. example: delivered ErrorCode: type: string description: If the message has failed or is undelivered, the error code may provide more information about what went wrong. example: '30003' MessageSid: type: string description: The unique ID of this message. example: b3877c40-da60-4998-90ad-b792e98472ms AccountSid: type: string description: The unique ID of the project this message is associated with. example: b3877c40-da60-4998-90ad-b792e98472af From: type: string description: The From number of the message. example: '+15551234567' To: type: string description: The To number of the message. example: '+15559876543' Body: type: string description: The body of the message. example: Hey, your order has shipped! NumMedia: type: integer format: int32 description: The number of media files that were included with the message. example: 0 NumSegments: type: integer format: int32 description: |- The number of segments that make up the entire message. If the body exceeds 160 GSM-7 characters or 70 UCS-2 characters, it is automatically split into smaller segments that are annotated for reconstruction on the recipient handset. example: 1 required: - MessageStatus - MessageSid - AccountSid - From - To - Body - NumMedia - NumSegments unevaluatedProperties: not: {} description: |- Payload sent by SignalWire to your SMS Status Callback URL when the status of an SMS/MMS message changes. Configure this callback using the `StatusCallback` parameter when [sending an outgoing message](/docs/compatibility-api/rest/messages/create-message). There are 8 possible message statuses: | Status | Description | |--------|-------------| | `queued` | The API request was processed and the message is waiting to be sent. | | `sending` | The message is being transmitted to the nearest upstream carrier. | | `sent` | The nearest upstream carrier has accepted the message. | | `delivered` | The nearest upstream carrier confirmed receipt of the message. | | `undelivered` | SignalWire received notice from the upstream carrier that the message was not delivered. | | `failed` | SignalWire could not send the message. There is no charge for failed messages. | | `receiving` | SignalWire has received and is currently processing an inbound message. | | `received` | The inbound message has been received by a number in your account. | SignalWire only marks a message as `delivered` when it receives a Delivery Receipt (DLR) from the receiving carrier confirming entry into the end carrier's network. `sent` means the message left SignalWire and reached the downstream peer. Some carriers send delayed DLRs; others send none at all. MMS messages never receive DLRs, so they will only ever reach `sent` status. responses: '200': description: Webhook received description: |- Payload sent by SignalWire to your SMS Status Callback URL when the status of an SMS/MMS message changes. Configure this callback using the `StatusCallback` parameter when [sending an outgoing message](/docs/compatibility-api/rest/messages/create-message). There are 8 possible message statuses: | Status | Description | |--------|-------------| | `queued` | The API request was processed and the message is waiting to be sent. | | `sending` | The message is being transmitted to the nearest upstream carrier. | | `sent` | The nearest upstream carrier has accepted the message. | | `delivered` | The nearest upstream carrier confirmed receipt of the message. | | `undelivered` | SignalWire received notice from the upstream carrier that the message was not delivered. | | `failed` | SignalWire could not send the message. There is no charge for failed messages. | | `receiving` | SignalWire has received and is currently processing an inbound message. | | `received` | The inbound message has been received by a number in your account. | SignalWire only marks a message as `delivered` when it receives a Delivery Receipt (DLR) from the receiving carrier confirming entry into the end carrier's network. `sent` means the message left SignalWire and reached the downstream peer. Some carriers send delayed DLRs; others send none at all. MMS messages never receive DLRs, so they will only ever reach `sent` status. tags: - Messages