openapi: 3.2.0 info: title: Twilio API definition for public-api voice V3Transcriptions… description: Powers Twilio public-api voice contact: name: voice-services email: voice-services@twilio.com license: name: Proprietary and protected url: https://www.twilio.com/ version: 1.0.0 x-twilio: apiStandards: v1.0 servers: - url: https://voice.twilio.com security: - accountSid_authToken: [] tags: - name: V3Transcriptions paths: /v3/Transcriptions/{transcriptionId}: x-twilio: defaultOutputProperties: - operationId - status - statusUrl pathType: instance get: tags: - V3Transcriptions summary: Fetch metadata about a specific transcription operationId: FetchTranscription parameters: - name: transcriptionId in: path required: true description: The unique identifier of the transcription to fetch schema: type: string pattern: ^voice_transcription_[0-9a-zA-Z]{26}$ example: voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1 responses: '200': description: Success headers: Retry-After: schema: type: integer description: Recommended number of seconds to wait before polling again if status is PENDING or RUNNING example: 5 content: application/json: schema: $ref: '#/components/schemas/voice.v3.transcription.LongRunningOperationResponse' example: operationId: voice_transcription_7n7hnd7sf68yfv5re42nvvz7aa status: COMPLETED statusUrl: https://voice.twilio.com/v3/Transcriptions/voice_transcription_7n7hnd7sf68yfv5re42nvvz7aa transcription: id: voice_transcription_7n7hnd7sf68yfv5re42nvvz7aa accountId: REDACTED_TWILIO_ACCOUNT_SID status: COMPLETED transcriptionConfigurationId: voice_transcriptionconfiguration_5pe8jw3ahdmsh7zr06yh4d45x1 mediaUrl: null sourceId: RExxxxxxxxxxxxxxxxxxxxxxxxxxxxx audioStartedAt: '2026-03-10T19:42:16Z' conversationId: conv_conversation_01k1etx3jbfx88476ccja0889c links: conversation: https://conversations.twilio.com/v2/Conversations/conv_conversation_01k1etx3jbfx88476ccja0889c participants: - type: CUSTOMER address: '+15551234567' name: Jane Doe audioChannelIndex: 1 - type: HUMAN_AGENT address: '+15559876543' name: Agent Smith audioChannelIndex: 2 duration: 120 resolvedConfiguration: transcriptionEngine: deepgram speechModel: nova-3 language: en-US transcriptionStatusCallback: url: https://example.com/transcription/callback method: POST events: null conversationConfigurationId: conv_configuration_5pe8jw3ahdmsh7zr06yh4d45x1 participantDefaults: - audioChannelIndex: 1 type: CUSTOMER - audioChannelIndex: 2 type: AI_AGENT createdAt: '2026-04-02T19:25:20Z' updatedAt: '2026-04-02T19:25:20Z' url: https://voice.twilio.com/v3/Transcriptions/voice_transcription_7n7hnd7sf68yfv5re42nvvz7aa '400': description: Bad Request content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '401': description: Unauthorized content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '403': description: Forbidden content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '404': description: Not Found content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '429': description: Too Many Requests headers: Retry-After: schema: type: integer description: Number of seconds to wait before retrying content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '500': description: Internal Server Error content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' /v3/Transcriptions: x-twilio: defaultOutputProperties: - status - statusUrl - transcription pathType: list get: tags: - V3Transcriptions summary: Retrieves a paginated, filterable list of transcriptions for the account… operationId: ListV3Transcriptions description: 'Returns the account''s transcriptions, newest first. Filters combine with AND, and paging uses the opaque cursors in meta rather than page numbers: pass meta.nextToken to advance and meta.previousToken to go back. A token is only valid for the filter set that produced it, so changing sourceId or the date range means starting a new walk. Items are the transcription resource itself. Create and fetch-by-id return the long running operation envelope instead, because creation is asynchronous.' parameters: - name: createdAfter in: query required: false description: Only include transcriptions created at or after this time (inclusive) schema: type: string format: date-time example: '2026-01-01T00:00:00Z' - name: createdBefore in: query required: false description: Only include transcriptions created strictly before this time (exclusive) schema: type: string format: date-time example: '2026-02-01T00:00:00Z' - name: languageCode in: query required: false description: Only include transcriptions whose resolved language matches this value exactly. The comparison is case sensitive, so use the stored form, for example en-US. schema: type: string example: en-US - name: sourceId in: query required: false description: Only include transcriptions for this source audio. Must be a Recording SID in lowercase hex; anything else is rejected with a 400. schema: type: string pattern: ^RE[0-9a-f]{32}$ example: REe3a2b046e52271b586425c61d84ca90e - name: status in: query required: false description: Only include transcriptions in this status schema: type: string enum: - PENDING - RUNNING - COMPLETED - FAILED example: COMPLETED - name: pageSize in: query required: false description: Number of results per page. This endpoint caps at 100, which is lower than the shared pagination component's ceiling and matches what the service enforces. schema: type: integer minimum: 1 maximum: 100 default: 50 example: 50 - name: pageToken in: query required: false description: Opaque cursor for retrieving the next or previous page of results schema: type: string example: aWQ9dm9pY2VfdHJhbnNjcmlwdGlvbl83bjdobmQ3c2Y2OHlmdjVyZTQybnZ2ejdhYSZjcmVhdGVkQXQ9MjAyNi0wNC0wMlQxOToyNToyMC4wMDBaJl9fc2Y9MA responses: '200': description: A page of transcriptions matching the given filters content: application/json: schema: $ref: '#/components/schemas/voice.v3.transcription.TranscriptionList' example: transcriptions: - id: voice_transcription_7n7hnd7sf68yfv5re42nvvz7aa accountId: REDACTED_TWILIO_ACCOUNT_SID status: COMPLETED transcriptionConfigurationId: voice_transcriptionconfiguration_3rthm325nansqmqvc1rrzymn1h sourceId: REe3a2b046e52271b586425c61d84ca90e audioStartedAt: '2026-04-02T19:25:20Z' conversationId: conv_conversation_01k1etx3jbfx88476ccja0889c links: conversation: https://conversations.twilio.com/v2/Conversations/conv_conversation_01k1etx3jbfx88476ccja0889c participants: - type: CUSTOMER address: '+15551234567' audioChannelIndex: 1 - type: HUMAN_AGENT address: '+15559876543' audioChannelIndex: 2 createdAt: '2026-04-02T19:25:20Z' updatedAt: '2026-04-02T19:27:41Z' url: https://voice.twilio.com/v3/Transcriptions/voice_transcription_7n7hnd7sf68yfv5re42nvvz7aa - id: voice_transcription_4abcde1234567890abcde12345 accountId: REDACTED_TWILIO_ACCOUNT_SID status: RUNNING transcriptionConfigurationId: voice_transcriptionconfiguration_3rthm325nansqmqvc1rrzymn1h mediaUrl: https://example.com/audio/recording.wav audioStartedAt: '2026-04-02T18:10:05Z' participants: - type: CUSTOMER address: '+15551234567' audioChannelIndex: 1 createdAt: '2026-04-02T18:10:05Z' updatedAt: '2026-04-02T18:10:09Z' url: https://voice.twilio.com/v3/Transcriptions/voice_transcription_4abcde1234567890abcde12345 meta: key: transcriptions pageSize: 2 nextToken: aWQ9dm9pY2VfdHJhbnNjcmlwdGlvbl80YWJjZGUxMjM0NTY3ODkwYWJjZGUxMjM0NSZjcmVhdGVkQXQ9MjAyNi0wNC0wMlQxODoxMDowNS4wMDBaJl9fc2Y9MA previousToken: null '400': description: Bad Request content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '401': description: Unauthorized content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '403': description: Forbidden content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '422': description: Returned only when filtering by sourceId whose total historical item count exceeds the service's scan cap. This is a fixed data volume limit on that one source rather than a problem with the request, so narrowing the other filters or retrying will not help. Error code 17535. content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '429': description: Too Many Requests headers: Retry-After: schema: type: integer description: Number of seconds to wait before retrying content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '500': description: Internal Server Error content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' post: tags: - V3Transcriptions summary: Creates a new transcription from either a sourceId or a mediaUrl. operationId: CreateV3Transcriptions requestBody: required: true content: application/json: schema: oneOf: - $ref: '#/components/schemas/voice.v3.transcription.CreateRequestWithSourceId' - $ref: '#/components/schemas/voice.v3.transcription.CreateRequestWithMediaUrl' discriminator: propertyName: inputSource mapping: SOURCE_ID: '#/components/schemas/voice.v3.transcription.CreateRequestWithSourceId' MEDIA_URL: '#/components/schemas/voice.v3.transcription.CreateRequestWithMediaUrl' examples: withSourceId: summary: Transcription from Recording ID value: transcriptionConfigurationId: voice_transcriptionconfiguration_5pe8jw3ahdmsh7zr06yh4d45x1 sourceId: RExxxxxxxxxxxxxxxxxxxxxxxxxxxxx participants: - audioChannelIndex: 1 type: CUSTOMER address: '+15551234567' name: Jane Doe - audioChannelIndex: 2 type: HUMAN_AGENT address: '+15559876543' name: Agent Smith withMediaUrl: summary: Transcription from Media URL value: transcriptionConfigurationId: voice_transcriptionconfiguration_5pe8jw3ahdmsh7zr06yh4d45x1 mediaUrl: https://example.com/audio/recording.wav audioStartedAt: '2025-11-19T19:42:16Z' participants: - audioChannelIndex: 1 type: CUSTOMER address: '+15551234567' name: Jane Doe - audioChannelIndex: 2 type: HUMAN_AGENT address: '+15559876543' name: Agent Smith parameters: - name: Idempotency-Key in: header description: A unique key to ensure idempotency. We recommend using UUID v7. Requests with the same key within the idempotency window return the original response. required: false schema: type: string maxLength: 128 example: 01926e40-a5e2-7000-8000-2b2c5a4e5d7b responses: '202': description: 'Transcription request accepted and will be processed asynchronously. Poll the statusUrl (or Location header) to track progress. ' headers: Operation-Id: description: 'Server-generated unique identifier for the transcription (TTID format). This value is also returned as transcription.id in the response body and as the transcriptionId path parameter for the GET /Transcriptions/{transcriptionId} endpoint. Use statusUrl (or the Location response header) to poll for operation progress. ' schema: type: string pattern: ^voice_transcription_[0-9a-zA-Z]{26}$ example: voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1 Location: description: 'URI of the status monitoring endpoint for this operation (RFC 9110 Section 10.2.2). Poll this URL to check progress. ' style: simple explode: false schema: type: string format: uri example: https://voice.twilio.com/v3/Transcriptions/voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1 Retry-After: description: Recommended number of seconds to wait before polling again (RFC 9110 Section 10.2.3) style: simple explode: false schema: type: integer example: 5 Idempotency-Key: description: Echoes the Idempotency-Key from the request, if provided. style: simple explode: false schema: type: string maxLength: 128 example: 01926e40-a5e2-7000-8000-2b2c5a4e5d7b content: application/json: schema: $ref: '#/components/schemas/voice.v3.transcription.LongRunningOperation202Response' example: status: PENDING statusUrl: https://voice.twilio.com/v3/Transcriptions/voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1 transcription: id: voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1 accountId: REDACTED_TWILIO_ACCOUNT_SID status: PENDING transcriptionConfigurationId: voice_transcriptionconfiguration_5pe8jw3ahdmsh7zr06yh4d45x1 sourceId: REe3a2b046e52271b586425c61d84ca90e audioStartedAt: '2026-03-10T19:42:16Z' conversationId: null participants: - type: CUSTOMER address: '+15551234567' name: Jane Doe audioChannelIndex: 1 - type: HUMAN_AGENT address: '+15559876543' name: Agent Smith audioChannelIndex: 2 duration: null resolvedConfiguration: transcriptionEngine: deepgram speechModel: nova-3 language: en-US transcriptionStatusCallback: url: https://example.com/transcription/callback method: POST events: null conversationConfigurationId: conv_configuration_01k1etx3jbfx88476ccja0889c participantDefaults: - audioChannelIndex: 1 type: CUSTOMER - audioChannelIndex: 2 type: AI_AGENT createdAt: '2026-04-02T19:25:20.810012321Z' updatedAt: '2026-04-02T19:25:20.810012321Z' url: https://voice.twilio.com/v3/Transcriptions/voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1 '400': description: Bad Request content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '401': description: Unauthorized content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '403': description: Forbidden - account not eligible content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '404': description: Not Found - the referenced recording does not exist content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '422': description: Unprocessable Entity content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '429': description: Too Many Requests headers: Retry-After: schema: type: integer description: Number of seconds to wait before retrying content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' '500': description: Internal Server Error content: application/json: schema: description: 'The error response from a Twilio service, compliant with RFC-9457 (Problem Details for HTTP APIs). See https://www.rfc-editor.org/rfc/rfc9457.html for the specification. ' type: object required: - type - title - status - code properties: type: description: 'A URI reference (RFC3986) that identifies the problem type. This URI should resolve to human-readable documentation for the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). For Twilio errors, this should be a URL to https://www.twilio.com/docs/api/errors/{code} ' type: string format: uri-reference example: https://www.twilio.com/docs/api/errors/20001 title: description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. ' type: string minLength: 16 maxLength: 128 example: Invalid parameter status: description: 'The HTTP status code generated by the origin server for this occurrence of the problem. This is the same as the HTTP status code returned in the response. ' type: integer example: 400 detail: description: 'A human-readable explanation specific to this occurrence of the problem. This field''s value can change between different occurrences of the same problem type to provide specific details. ' type: - string - 'null' minLength: 16 maxLength: 1024 example: The 'PhoneNumber' parameter is required but was not provided. instance: description: 'A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. This can be used for correlation and debugging. ' type: - string - 'null' format: uri-reference example: /api/v1/accounts/AC123/calls/CA456 code: description: 'Twilio-specific error code (extension member). This numeric code uniquely identifies the error type within Twilio''s error taxonomy and can be used for programmatic handling. Registered at https://www.twilio.com/docs/api/errors ' type: integer example: 20001 errors: description: 'Twilio-specific extension for validation errors (typically HTTP 400/422). Contains an array of individual field-level validation errors, each with a human-readable detail message and a JSON Pointer (RFC 6901) indicating the location of the error in the request. This is particularly useful for request validation failures where multiple fields may have errors. ' type: - array - 'null' items: type: object required: - detail - pointer properties: detail: type: string description: A human-readable explanation of the validation error for this specific field. minLength: 16 maxLength: 1024 example: must be a positive integer pointer: type: string description: A JSON Pointer (RFC 6901) to the location in the request where the error occurred. example: '#/age' example: - detail: must be a positive integer pointer: '#/age' - detail: must be 'green', 'red' or 'blue' pointer: '#/profile/color' components: schemas: voice.v3.transcription.TranscriptionList: type: object required: - transcriptions - meta properties: transcriptions: type: array description: List of transcription resources items: $ref: '#/components/schemas/voice.v3.transcription.Transcription' meta: type: object properties: key: description: A key, sibling to the `meta` object that holds the actual list of resources type: string pageSize: description: The actual number of resources returned in the response type: integer previousToken: type: string nextToken: type: string required: - key - pageSize voice.v3.transcription.ResolvedConfiguration: type: object properties: transcriptionEngine: type: string description: The engine used for transcription (Deepgram, Google, or auto) example: deepgram speechModel: type: string description: The speech model used for transcription (e.g., nova-2, nova-3, chirp_2) example: nova-3 language: type: string description: The language code for transcription example: multi transcriptionStatusCallback: $ref: '#/components/schemas/voice.v3.transcription.TranscriptionStatusCallback' conversationConfigurationId: type: - string - 'null' pattern: ^conv_configuration_[a-zA-Z0-9]{26}$ description: Maestro conversation configuration ID example: conv_configuration_01k1etx3jbfx88476ccja0889c participantDefaults: type: array description: Default participant configurations for the transcription items: type: object required: - audioChannelIndex - type properties: audioChannelIndex: type: integer description: One-based index of the audio channel minimum: 1 maximum: 2 example: 1 type: type: string description: The participant role type enum: - CUSTOMER - HUMAN_AGENT - AI_AGENT example: CUSTOMER voice.v3.transcription.Participant: type: object required: - audioChannelIndex properties: type: type: string description: The role of this participant in the conversation. enum: - CUSTOMER - HUMAN_AGENT - AI_AGENT example: CUSTOMER address: type: string description: 'The phone number or identifier for this participant (E.164 format for phone numbers). Used to correlate this participant with their profile and conversation history. ' example: '+15551234567' name: type: string description: User-defined name for this participant example: Jane Doe audioChannelIndex: type: integer description: One-based index of the audio channel in a multi-channel recording minimum: 1 maximum: 2 example: 1 voice.v3.transcription.LongRunningOperationResponse: description: 'Status response for a transcription operation. Returns the current state of the operation along with the full transcription resource. Poll this response to track progress from acceptance through to completion or failure. ' type: object required: - operationId - status - statusUrl - transcription properties: operationId: type: string pattern: ^voice_transcription_[0-9a-zA-Z]{26}$ description: Unique identifier for the transcription operation. example: voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1 status: type: string enum: - PENDING - RUNNING - COMPLETED - FAILED description: 'Current status of the transcription operation. PENDING: accepted but not yet started. RUNNING: currently in progress. COMPLETED: successfully completed. FAILED: failed and cannot be completed. ' example: RUNNING statusUrl: type: string format: uri description: URL to poll for the latest operation status. example: https://voice.twilio.com/v3/Transcriptions/voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1 transcription: $ref: '#/components/schemas/voice.v3.transcription.Transcription' voice.v3.transcription.CreateRequestWithSourceId: type: object additionalProperties: false required: - transcriptionConfigurationId - sourceId properties: transcriptionConfigurationId: type: string pattern: ^voice_transcriptionconfiguration_[0-9a-z]{26}$ description: The ID of the transcription configuration to use example: voice_transcriptionconfiguration_5pe8jw3ahdmsh7zr06yh4d45x1 inputSource: type: string enum: - SOURCE_ID description: Discriminator indicating the input source type example: SOURCE_ID sourceId: type: string maxLength: 64 description: 'The SID or TTID of the source audio to transcribe (e.g. a Twilio Recording SID). When provided, audioStartedAt is inferred from the recording''s start time and does not need to be supplied by the caller. ' example: RExxxxxxxxxxxxxxxxxxxxxxxxxxxxx participants: type: array description: Array of participants in the conversation maxItems: 2 items: $ref: '#/components/schemas/voice.v3.transcription.Participant' voice.v3.transcription.LongRunningOperation202Response: description: 'Response envelope for long-running operations (202 Accepted pattern). Returned immediately on acceptance and on each status poll. Extensible to allow additional fields in future versions. ' type: object required: - status - statusUrl - transcription properties: status: type: string enum: - PENDING - RUNNING - COMPLETED - FAILED description: 'Current status of the long-running operation. PENDING: accepted but not yet started. RUNNING: currently in progress. COMPLETED: successfully completed. FAILED: failed and cannot be completed. ' example: PENDING statusUrl: type: string format: uri description: 'URI to poll for operation status. Mirrors the Location response header. Provided as a body field for programmatic access by JSON-parsing clients (RFC 9110 Section 15.3.3). ' example: https://voice.twilio.com/v3/Transcriptions/voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1 transcription: $ref: '#/components/schemas/voice.v3.transcription.Transcription' voice.v3.transcription.Transcription: type: object required: - id - accountId - status - transcriptionConfigurationId - createdAt - updatedAt - url properties: id: type: string pattern: ^voice_transcription_[0-9a-zA-Z]{26}$ description: Unique identifier for a Transcription. This is also the transcriptionId returned in the LRO 202 response. example: voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1 accountId: type: string pattern: ^AC[0-9a-f]{32}$ description: Twilio Account SID example: REDACTED_TWILIO_ACCOUNT_SID status: type: string enum: - PENDING - RUNNING - COMPLETED - FAILED description: The current status of the transcription operation example: PENDING transcriptionConfigurationId: type: string pattern: ^voice_transcriptionconfiguration_[0-9a-z]{26}$ description: Unique identifier for a Transcription configuration. example: voice_transcriptionconfiguration_5pe8jw3ahdmsh7zr06yh4d45x1 mediaUrl: type: - string - 'null' format: uri description: The third party media URL example: http://mymedia.com sourceId: type: - string - 'null' description: The source ID (recording ID) - used for tracking only example: REe3a2b046e52271b586425c61d84ca90e audioStartedAt: type: string format: date-time description: 'The call/recording start time. When the transcription was created using a sourceId, this value is inferred from the recording resource''s start time. When created using a mediaUrl, this reflects the value supplied by the caller. ' example: '2025-11-19T19:42:16Z' conversationId: type: - string - 'null' pattern: ^conv_conversation_[a-zA-Z0-9]{26}$ description: Maestro conversation ID, populated once the transcription has been stored in Maestro. example: conv_conversation_01k1etx3jbfx88476ccja0889c participants: type: array description: Array of participants in the conversation items: $ref: '#/components/schemas/voice.v3.transcription.Participant' duration: type: - integer - 'null' description: Audio duration in seconds example: 1000 resolvedConfiguration: $ref: '#/components/schemas/voice.v3.transcription.ResolvedConfiguration' createdAt: type: string format: date-time description: When this transcript was created example: '2025-11-19T19:42:16Z' updatedAt: type: string format: date-time description: When this transcript was last updated example: '2025-11-19T19:42:16Z' url: type: string format: uri description: The URL of this resource example: https://voice.twilio.com/v3/Transcriptions/voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1 links: type: - object - 'null' format: uri-map description: 'Absolute URLs of resources related to this Transcription. Includes `conversation`, the Conversations API resource for this Transcription''s `conversationId`, once the transcript has been stored. Omitted entirely when there is no related resource to link to. ' voice.v3.transcription.CreateRequestWithMediaUrl: type: object additionalProperties: false required: - transcriptionConfigurationId properties: transcriptionConfigurationId: type: string pattern: ^voice_transcriptionconfiguration_[0-9a-z]{26}$ description: The ID of the transcription configuration to use example: voice_transcriptionconfiguration_5pe8jw3ahdmsh7zr06yh4d45x1 inputSource: type: string enum: - MEDIA_URL description: Discriminator indicating the input source type example: MEDIA_URL mediaUrl: type: string format: uri description: URL to the media file to transcribe example: https://example.com/audio/recording.wav audioStartedAt: type: string format: date-time description: The start time of the audio recording example: '2025-11-19T19:42:16Z' participants: type: array description: 'Participants in the conversation. If omitted or partially specified, defaults from the transcription configuration will be applied. ' maxItems: 2 items: $ref: '#/components/schemas/voice.v3.transcription.Participant' voice.v3.transcription.TranscriptionStatusCallback: type: object properties: url: type: string format: uri description: The URL to call when transcription status changes example: https://example.com/transcriptions/default-webhook method: type: string enum: - POST description: The HTTP method to use for the callback, currently only POST is supported example: POST events: type: - array - 'null' description: The transcription events that will trigger the callback items: type: string enum: - COMPLETED example: - COMPLETED securitySchemes: accountSid_authToken: scheme: basic type: http