telnyx 7.26.0 → 7.27.0

package/src/resources/speech-to-text/speech-to-text.ts

@@ -263,9 +263,10 @@ export interface SpeechToTextRetrieveTranscriptionParams {
   /**
    * Silence duration (in milliseconds) that triggers end-of-speech detection. When
    * set, the engine uses this value to determine when a speaker has stopped talking.
-   * Supported by `xAI`, `Deepgram`, `Google`, `Speechmatics`, and `Soniox`. `Soniox`
-   * accepts values between 500 and 3000. Other engines may not support this
-   * parameter.
+   * Supported by `xAI`, `Deepgram`, `Google`, `Speechmatics`
+   * (`speechmatics/standard` only; `speechmatics/linden-1` uses fixed service-side
+   * voice activity detection and ignores it), and `Soniox`. `Soniox` accepts values
+   * between 500 and 3000. Other engines may not support this parameter.
    */
   endpointing?: number;
 
@@ -289,7 +290,12 @@ export interface SpeechToTextRetrieveTranscriptionParams {
   /**
    * The language spoken in the audio stream. For `cohere/ar-stt`, this must be `ar`
    * or `en` — unlike other engines, Cohere does not auto-detect the language, and
-   * rejects unsupported values including `auto`; omitting it defaults to `ar`.
+   * rejects unsupported values including `auto`; omitting it defaults to `ar`. For
+   * `speechmatics/linden-1`, omitting it defaults to `en`; `auto`, `auto_beta`,
+   * `multi`, or a language outside its supported list is rejected when the
+   * connection is established. `speechmatics/linden-1` also accepts `en-US`,
+   * `en-GB`, `en-AU`, `cmn-Hans`, and `cmn-Hant`, which select the spelling or
+   * script variant (`en` alone uses the default spelling).
    */
   language?: string;
 
@@ -312,6 +318,7 @@ export interface SpeechToTextRetrieveTranscriptionParams {
     | 'openai/whisper-large-v3-turbo'
     | 'xai/grok-stt'
     | 'speechmatics/standard'
+    | 'speechmatics/linden-1'
     | 'soniox/stt-rt-v4'
     | 'nvidia/parakeet-v3'
     | 'omi-health/omi-med-stt-v1'
@@ -329,6 +336,7 @@ export interface SpeechToTextRetrieveTranscriptionParams {
    * Audio sample rate in Hz. Required when `input_format` is a raw encoding
    * (`linear16`, `linear32`) — those formats carry no header metadata. Ignored for
    * container formats (`mp3`, `wav`), which self-describe their rate.
+   * `speechmatics/linden-1` accepts only `16000`.
    */
   sample_rate?: number;
 }

package/src/resources/telephony-credentials.ts

@@ -102,10 +102,21 @@ export class TelephonyCredentials extends APIResource {
    *   await client.telephonyCredentials.createToken('id');
    * ```
    */
-  createToken(id: string, options?: RequestOptions): APIPromise<string> {
+  createToken(
+    id: string,
+    params: TelephonyCredentialCreateTokenParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<string> {
+    const { 'Idempotency-Key': idempotencyKey } = params ?? {};
     return this._client.post(path`/telephony_credentials/${id}/token`, {
       ...options,
-      headers: buildHeaders([{ Accept: 'text/plain' }, options?.headers]),
+      headers: buildHeaders([
+        {
+          Accept: 'text/plain',
+          ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined),
+        },
+        options?.headers,
+      ]),
     });
   }
 }
@@ -263,6 +274,16 @@ export interface TelephonyCredentialUpdateParams {
   tag?: string;
 }
 
+export interface TelephonyCredentialCreateTokenParams {
+  /**
+   * Unique key for safely retrying the same logical request. Generate a UUID v4 for
+   * each operation and reuse it only when retrying that operation with the same
+   * request body. Valid characters: A-Z, a-z, 0-9, -, and \_. Length: 1-255
+   * characters. Do not include sensitive data in the key.
+   */
+  'Idempotency-Key'?: string;
+}
+
 export declare namespace TelephonyCredentials {
   export {
     type TelephonyCredential as TelephonyCredential,
@@ -275,5 +296,6 @@ export declare namespace TelephonyCredentials {
     type TelephonyCredentialListParams as TelephonyCredentialListParams,
     type TelephonyCredentialCreateParams as TelephonyCredentialCreateParams,
     type TelephonyCredentialUpdateParams as TelephonyCredentialUpdateParams,
+    type TelephonyCredentialCreateTokenParams as TelephonyCredentialCreateTokenParams,
   };
 }

package/src/resources/texml/accounts/accounts.ts

@@ -67,7 +67,7 @@ export class Accounts extends APIResource {
    * ```ts
    * const texmlGetCallRecordingsResponseBody =
    *   await client.texml.accounts.retrieveRecordingsJson(
-   *     'account_sid',
+   *     'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
    *   );
    * ```
    */
@@ -86,7 +86,7 @@ export class Accounts extends APIResource {
    * ```ts
    * const response =
    *   await client.texml.accounts.retrieveTranscriptionsJson(
-   *     'account_sid',
+   *     'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
    *   );
    * ```
    */

package/src/resources/texml/accounts/calls/calls.ts

@@ -39,7 +39,7 @@ export class Calls extends APIResource {
    * ```ts
    * const response =
    *   await client.texml.accounts.calls.retrieveCalls(
-   *     'account_sid',
+   *     'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
    *   );
    * ```
    */
@@ -63,12 +63,12 @@ export class Calls extends APIResource {
 
   /**
    * Initiate an outbound TeXML call. Telnyx will request TeXML from the XML Request
-   * URL configured for the connection in the Mission Control Portal.
+   * URL configured for the TeXML Application in the Mission Control Portal.
    *
    * @example
    * ```ts
    * const response = await client.texml.accounts.calls.calls(
-   *   'account_sid',
+   *   'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
    *   { body: { Url: 'https://www.example.com/texml.xml' } },
    * );
    * ```
@@ -90,7 +90,7 @@ export class Calls extends APIResource {
    * ```ts
    * const callResource =
    *   await client.texml.accounts.calls.retrieve('call_sid', {
-   *     account_sid: 'account_sid',
+   *     account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
    *   });
    * ```
    */
@@ -107,7 +107,7 @@ export class Calls extends APIResource {
    * ```ts
    * const callResource =
    *   await client.texml.accounts.calls.update('call_sid', {
-   *     account_sid: 'account_sid',
+   *     account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
    *   });
    * ```
    */
@@ -128,7 +128,7 @@ export class Calls extends APIResource {
    * ```ts
    * const response =
    *   await client.texml.accounts.calls.siprecJson('call_sid', {
-   *     account_sid: 'account_sid',
+   *     account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
    *   });
    * ```
    */
@@ -153,7 +153,7 @@ export class Calls extends APIResource {
    * const response =
    *   await client.texml.accounts.calls.streamsJson(
    *     'call_sid',
-   *     { account_sid: 'account_sid' },
+   *     { account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9' },
    *   );
    * ```
    */
@@ -512,7 +512,12 @@ export namespace CallCallsParams {
     Url: string;
 
     /**
-     * The ID of the TeXML Application.
+     * The ID of the TeXML Application that will handle the call, for example
+     * `1293384261075731499`. The `ApplicationSid` name is kept for Twilio API
+     * compatibility, but the value is the numeric ID of one of your TeXML Applications
+     * (see the TeXML Applications API or the Mission Control Portal), not a Twilio
+     * `AP...` SID. If `Url` and `Texml` are omitted, Telnyx fetches instructions from
+     * the XML Request URL configured on this application.
      */
     ApplicationSid?: string;
 
@@ -842,7 +847,12 @@ export namespace CallCallsParams {
     Texml: string;
 
     /**
-     * The ID of the TeXML Application.
+     * The ID of the TeXML Application that will handle the call, for example
+     * `1293384261075731499`. The `ApplicationSid` name is kept for Twilio API
+     * compatibility, but the value is the numeric ID of one of your TeXML Applications
+     * (see the TeXML Applications API or the Mission Control Portal), not a Twilio
+     * `AP...` SID. If `Url` and `Texml` are omitted, Telnyx fetches instructions from
+     * the XML Request URL configured on this application.
      */
     ApplicationSid?: string;
 
@@ -1166,7 +1176,12 @@ export namespace CallCallsParams {
 
   export interface ApplicationDefault {
     /**
-     * The ID of the TeXML Application.
+     * The ID of the TeXML Application that will handle the call, for example
+     * `1293384261075731499`. The `ApplicationSid` name is kept for Twilio API
+     * compatibility, but the value is the numeric ID of one of your TeXML Applications
+     * (see the TeXML Applications API or the Mission Control Portal), not a Twilio
+     * `AP...` SID. If `Url` and `Texml` are omitted, Telnyx fetches instructions from
+     * the XML Request URL configured on this application.
      */
     ApplicationSid?: string;
 
@@ -1493,14 +1508,24 @@ export namespace CallCallsParams {
 
 export interface CallRetrieveParams {
   /**
-   * The id of the account the resource belongs to.
+   * The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 }
 
 export interface CallUpdateParams {
   /**
-   * Path param: The id of the account the resource belongs to.
+   * Path param: The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 
@@ -1551,7 +1576,12 @@ export interface CallUpdateParams {
 
 export interface CallSiprecJsonParams {
   /**
-   * Path param: The id of the account the resource belongs to.
+   * Path param: The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 
@@ -1611,7 +1641,12 @@ export interface CallSiprecJsonParams {
 
 export interface CallStreamsJsonParams {
   /**
-   * Path param: The id of the account the resource belongs to.
+   * Path param: The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 

package/src/resources/texml/accounts/calls/recordings-json.ts

@@ -19,7 +19,7 @@ export class RecordingsJson extends APIResource {
    * const texmlGetCallRecordingsResponseBody =
    *   await client.texml.accounts.calls.recordingsJson.retrieveRecordingsJson(
    *     'call_sid',
-   *     { account_sid: 'account_sid' },
+   *     { account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9' },
    *   );
    * ```
    */
@@ -40,7 +40,7 @@ export class RecordingsJson extends APIResource {
    * const texmlCreateCallRecordingResponseBody =
    *   await client.texml.accounts.calls.recordingsJson.recordingsJson(
    *     'call_sid',
-   *     { account_sid: 'account_sid' },
+   *     { account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9' },
    *   );
    * ```
    */
@@ -171,14 +171,24 @@ export type TwimlRecordingChannels = 1 | 2;
 
 export interface RecordingsJsonRetrieveRecordingsJsonParams {
   /**
-   * The id of the account the resource belongs to.
+   * The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 }
 
 export interface RecordingsJsonRecordingsJsonParams {
   /**
-   * Path param: The id of the account the resource belongs to.
+   * Path param: The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 

package/src/resources/texml/accounts/calls/recordings.ts

@@ -19,7 +19,10 @@ export class Recordings extends APIResource {
    * const texmlCreateCallRecordingResponseBody =
    *   await client.texml.accounts.calls.recordings.recordingSidJson(
    *     '6a09cdc3-8948-47f0-aa62-74ac943d6c58',
-   *     { account_sid: 'account_sid', call_sid: 'call_sid' },
+   *     {
+   *       account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
+   *       call_sid: 'call_sid',
+   *     },
    *   );
    * ```
    */
@@ -42,7 +45,12 @@ export class Recordings extends APIResource {
 
 export interface RecordingRecordingSidJsonParams {
   /**
-   * Path param: The id of the account the resource belongs to.
+   * Path param: The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 

package/src/resources/texml/accounts/calls/siprec.ts

@@ -18,7 +18,10 @@ export class Siprec extends APIResource {
    * const response =
    *   await client.texml.accounts.calls.siprec.siprecSidJson(
    *     'siprec_sid',
-   *     { account_sid: 'account_sid', call_sid: 'call_sid' },
+   *     {
+   *       account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
+   *       call_sid: 'call_sid',
+   *     },
    *   );
    * ```
    */
@@ -78,7 +81,12 @@ export interface SiprecSiprecSidJsonResponse {
 
 export interface SiprecSiprecSidJsonParams {
   /**
-   * Path param: The id of the account the resource belongs to.
+   * Path param: The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 

package/src/resources/texml/accounts/calls/streams.ts

@@ -18,7 +18,10 @@ export class Streams extends APIResource {
    * const response =
    *   await client.texml.accounts.calls.streams.streamingSidJson(
    *     '6a09cdc3-8948-47f0-aa62-74ac943d6c58',
-   *     { account_sid: 'account_sid', call_sid: 'call_sid' },
+   *     {
+   *       account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
+   *       call_sid: 'call_sid',
+   *     },
    *   );
    * ```
    */
@@ -64,7 +67,12 @@ export interface StreamStreamingSidJsonResponse {
 
 export interface StreamStreamingSidJsonParams {
   /**
-   * Path param: The id of the account the resource belongs to.
+   * Path param: The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 

package/src/resources/texml/accounts/conferences/conferences.ts

@@ -33,7 +33,7 @@ export class Conferences extends APIResource {
    * ```ts
    * const response =
    *   await client.texml.accounts.conferences.retrieveConferences(
-   *     'account_sid',
+   *     'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
    *   );
    * ```
    */
@@ -53,7 +53,7 @@ export class Conferences extends APIResource {
    * const conferenceResource =
    *   await client.texml.accounts.conferences.retrieve(
    *     'conference_sid',
-   *     { account_sid: 'account_sid' },
+   *     { account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9' },
    *   );
    * ```
    */
@@ -75,7 +75,7 @@ export class Conferences extends APIResource {
    * const conferenceResource =
    *   await client.texml.accounts.conferences.update(
    *     'conference_sid',
-   *     { account_sid: 'account_sid' },
+   *     { account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9' },
    *   );
    * ```
    */
@@ -100,7 +100,7 @@ export class Conferences extends APIResource {
    * const response =
    *   await client.texml.accounts.conferences.retrieveRecordings(
    *     'conference_sid',
-   *     { account_sid: 'account_sid' },
+   *     { account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9' },
    *   );
    * ```
    */
@@ -124,7 +124,7 @@ export class Conferences extends APIResource {
    * const texmlGetCallRecordingsResponseBody =
    *   await client.texml.accounts.conferences.retrieveRecordingsJson(
    *     'conference_sid',
-   *     { account_sid: 'account_sid' },
+   *     { account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9' },
    *   );
    * ```
    */
@@ -419,14 +419,24 @@ export interface ConferenceRetrieveConferencesParams {
 
 export interface ConferenceRetrieveParams {
   /**
-   * The id of the account the resource belongs to.
+   * The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 }
 
 export interface ConferenceUpdateParams {
   /**
-   * Path param: The id of the account the resource belongs to.
+   * Path param: The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 
@@ -451,14 +461,24 @@ export interface ConferenceUpdateParams {
 
 export interface ConferenceRetrieveRecordingsParams {
   /**
-   * The id of the account the resource belongs to.
+   * The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 }
 
 export interface ConferenceRetrieveRecordingsJsonParams {
   /**
-   * The id of the account the resource belongs to.
+   * The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 }

package/src/resources/texml/accounts/conferences/participants.ts

@@ -18,7 +18,7 @@ export class Participants extends APIResource {
    * const response =
    *   await client.texml.accounts.conferences.participants.retrieveParticipants(
    *     'conference_sid',
-   *     { account_sid: 'account_sid' },
+   *     { account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9' },
    *   );
    * ```
    */
@@ -43,7 +43,7 @@ export class Participants extends APIResource {
    * const response =
    *   await client.texml.accounts.conferences.participants.participants(
    *     'conference_sid',
-   *     { account_sid: 'account_sid' },
+   *     { account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9' },
    *   );
    * ```
    */
@@ -69,7 +69,7 @@ export class Participants extends APIResource {
    * await client.texml.accounts.conferences.participants.delete(
    *   'call_sid_or_participant_label',
    *   {
-   *     account_sid: 'account_sid',
+   *     account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
    *     conference_sid: 'conference_sid',
    *   },
    * );
@@ -97,7 +97,7 @@ export class Participants extends APIResource {
    *   await client.texml.accounts.conferences.participants.retrieve(
    *     'call_sid_or_participant_label',
    *     {
-   *       account_sid: 'account_sid',
+   *       account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
    *       conference_sid: 'conference_sid',
    *     },
    *   );
@@ -125,7 +125,7 @@ export class Participants extends APIResource {
    *   await client.texml.accounts.conferences.participants.update(
    *     'call_sid_or_participant_label',
    *     {
-   *       account_sid: 'account_sid',
+   *       account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
    *       conference_sid: 'conference_sid',
    *     },
    *   );
@@ -318,14 +318,24 @@ export interface ParticipantRetrieveParticipantsResponse {
 
 export interface ParticipantRetrieveParticipantsParams {
   /**
-   * The id of the account the resource belongs to.
+   * The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 }
 
 export interface ParticipantParticipantsParams {
   /**
-   * Path param: The id of the account the resource belongs to.
+   * Path param: The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 
@@ -693,7 +703,12 @@ export namespace ParticipantParticipantsParams {
 
 export interface ParticipantDeleteParams {
   /**
-   * The id of the account the resource belongs to.
+   * The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 
@@ -705,7 +720,12 @@ export interface ParticipantDeleteParams {
 
 export interface ParticipantRetrieveParams {
   /**
-   * The id of the account the resource belongs to.
+   * The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 
@@ -717,7 +737,12 @@ export interface ParticipantRetrieveParams {
 
 export interface ParticipantUpdateParams {
   /**
-   * Path param: The id of the account the resource belongs to.
+   * Path param: The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;