telnyx 7.25.0 → 7.27.0

package/resources/llm-token-gateway/token-keys.d.ts

@@ -0,0 +1,318 @@
+import { APIResource } from "../../core/resource.js";
+import * as TokenGroupsAPI from "./token-groups.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { DefaultFlatPagination, type DefaultFlatPaginationParams, PagePromise } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * Manage and report AI Gateway usage.
+ */
+export declare class TokenKeys extends APIResource {
+    /**
+     * List gateway token keys within the authenticated Telnyx account. Foreign and
+     * unknown resource IDs return the same 404 response.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const tokenKey of client.llmTokenGateway.tokenKeys.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: TokenKeyListParams | null | undefined, options?: RequestOptions): PagePromise<TokenKeysDefaultFlatPagination, TokenKey>;
+    /**
+     * Create gateway token key within the authenticated Telnyx account. Foreign and
+     * unknown resource IDs return the same 404 response. The token secret is returned
+     * only on the original create response. A replay returns metadata without the
+     * secret. Provisioning is advisory; ready is not a guarantee of inference
+     * availability.
+     *
+     * @example
+     * ```ts
+     * const tokenKeyResponse =
+     *   await client.llmTokenGateway.tokenKeys.create({
+     *     name: 'support-service',
+     *     token_group_id: '11111111-1111-4111-8111-111111111111',
+     *     'Idempotency-Key': 'Idempotency-Key',
+     *     max_parallel_requests: 5,
+     *   });
+     * ```
+     */
+    create(params: TokenKeyCreateParams, options?: RequestOptions): APIPromise<TokenKeyResponse>;
+    /**
+     * Revoke this token key. Acknowledged revocation blocks new admissions with the
+     * key; requests already admitted may complete. Historical usage attribution is
+     * retained. Other keys in the group are unchanged.
+     *
+     * @example
+     * ```ts
+     * await client.llmTokenGateway.tokenKeys.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   {
+     *     'Idempotency-Key': 'Idempotency-Key',
+     *     'If-Match': 'If-Match',
+     *   },
+     * );
+     * ```
+     */
+    delete(id: string, params: TokenKeyDeleteParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Get gateway token key within the authenticated Telnyx account. Foreign and
+     * unknown resource IDs return the same 404 response.
+     *
+     * @example
+     * ```ts
+     * const tokenKeyResponse =
+     *   await client.llmTokenGateway.tokenKeys.retrieve(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    retrieve(id: string, options?: RequestOptions): APIPromise<TokenKeyResponse>;
+    /**
+     * Update gateway token key within the authenticated Telnyx account. Foreign and
+     * unknown resource IDs return the same 404 response. Omitted fields are preserved.
+     * Null clears max_parallel_requests; null resets budget and rate limits to their
+     * maximum. A stale If-Match returns 412.
+     *
+     * @example
+     * ```ts
+     * const tokenKeyResponse =
+     *   await client.llmTokenGateway.tokenKeys.update(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     {
+     *       'Idempotency-Key': 'Idempotency-Key',
+     *       'If-Match': 'If-Match',
+     *       max_parallel_requests: 5,
+     *     },
+     *   );
+     * ```
+     */
+    update(id: string, params: TokenKeyUpdateParams, options?: RequestOptions): APIPromise<TokenKeyResponse>;
+}
+export type TokenKeysDefaultFlatPagination = DefaultFlatPagination<TokenKey>;
+export interface TokenKey {
+    id: string;
+    allowed_models: Array<string> | null;
+    blocked: boolean;
+    budget_duration: TokenGroupsAPI.BudgetDuration | null;
+    budget_started_at: string | null;
+    created_at: string;
+    expires_at: string | null;
+    /**
+     * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
+     * never binary float accounting.
+     */
+    max_budget: number | null;
+    name: string;
+    record_type: 'token_key';
+    /**
+     * Require a nonempty caller-asserted end-user ID; not proof of identity.
+     */
+    required_end_user_id: boolean;
+    /**
+     * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
+     * never binary float accounting.
+     */
+    reserved_spend: number;
+    resets_at: string | null;
+    /**
+     * Stored key limit; set to the maximum when the key was written without one (on a
+     * blocked key, null is kept until the key is unblocked).
+     */
+    rpm_limit: number | null;
+    /**
+     * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
+     * never binary float accounting.
+     */
+    spend: number;
+    token_group_id: string;
+    token_user_id: string | null;
+    /**
+     * Stored key limit; set to the maximum when the key was written without one (on a
+     * blocked key, null is kept until the key is unblocked).
+     */
+    tpm_limit: number | null;
+    updated_at: string;
+    version: number;
+    /**
+     * Optional maximum concurrent reserved/dispatched cache misses across replicas.
+     * Null means no concurrency cap. Cache hits do not consume slots; unknown usage
+     * retains its budget hold without a slot.
+     */
+    max_parallel_requests?: number | null;
+    /**
+     * Provisioning state of the key's current policy. `pending`: retry readiness with
+     * bounded backoff (treat `unknown` the same). `inactive` and `unsupported` are
+     * terminal until the key, group, user or catalog changes. `unavailable` means
+     * provisioning is stuck and is retried slowly; surface it. Absent while the
+     * gateway runs in compatibility mode.
+     */
+    provisioning?: 'ready' | 'pending' | 'unavailable' | 'inactive' | 'unsupported' | 'unknown';
+}
+export interface TokenKeyResponse {
+    data: TokenKey;
+}
+export interface TokenKeyListParams extends DefaultFlatPaginationParams {
+    /**
+     * Required after page 1; account/filter-bound 15-minute stable snapshot;
+     * expired/mismatch 409.
+     */
+    'page[snapshot]'?: string;
+    token_group_id?: string;
+    token_user_id?: string;
+}
+export interface TokenKeyCreateParams {
+    /**
+     * Body param
+     */
+    name: string;
+    /**
+     * Body param
+     */
+    token_group_id: string;
+    /**
+     * Header param: 24h, scoped by account+method+path. Same key/body returns same
+     * outcome; changed body 409; in-progress 409 with Retry-After. Token-create replay
+     * returns 200 metadata WITHOUT secret.
+     */
+    'Idempotency-Key': string;
+    /**
+     * Body param
+     */
+    allowed_models?: Array<string> | null;
+    /**
+     * Body param
+     */
+    blocked?: boolean;
+    /**
+     * Body param
+     */
+    budget_duration?: TokenGroupsAPI.BudgetDuration | null;
+    /**
+     * Body param
+     */
+    expires_at?: string | null;
+    /**
+     * Body param: USD, decimal precision at most 6 places; parse exactly to integer
+     * micro-USD, never binary float accounting.
+     */
+    max_budget?: number | null;
+    /**
+     * Body param: Optional maximum concurrent reserved/dispatched cache misses across
+     * replicas. Null means no concurrency cap. Cache hits do not consume slots;
+     * unknown usage retains its budget hold without a slot.
+     */
+    max_parallel_requests?: number | null;
+    /**
+     * Body param: Require a nonempty caller-asserted end-user ID; not proof of
+     * identity.
+     */
+    required_end_user_id?: boolean;
+    /**
+     * Body param: Omitted or null defaults to the maximum (6000) (on a blocked key,
+     * null is kept until the key is unblocked); a value below the minimum (1) or above
+     * the maximum is rejected with 400 limit_out_of_range; a malformed value
+     * (negative, wrong type or precision) is 400 invalid_request. Block the key
+     * (blocked: true) to deny it; blocking is always accepted.
+     */
+    rpm_limit?: number | null;
+    /**
+     * Body param
+     */
+    token_user_id?: string | null;
+    /**
+     * Body param: Omitted or null defaults to the maximum (10000000) (on a blocked
+     * key, null is kept until the key is unblocked); a value below the minimum (1) or
+     * above the maximum is rejected with 400 limit_out_of_range; a malformed value
+     * (negative, wrong type or precision) is 400 invalid_request. Block the key
+     * (blocked: true) to deny it; blocking is always accepted.
+     */
+    tpm_limit?: number | null;
+}
+export interface TokenKeyDeleteParams {
+    /**
+     * 24h, scoped by account+method+path. Same key/body returns same outcome; changed
+     * body 409; in-progress 409 with Retry-After. Token-create replay returns 200
+     * metadata WITHOUT secret.
+     */
+    'Idempotency-Key': string;
+    /**
+     * Exact quoted resource-version ETag; an exact intermediary-weakened echo W/"n" is
+     * accepted. Wildcard, combined and malformed validators are rejected; stale 412;
+     * missing 428. HTTP field names are case-insensitive. Replayed idempotent result
+     * is checked first.
+     */
+    'If-Match': string;
+}
+export interface TokenKeyUpdateParams {
+    /**
+     * Header param: 24h, scoped by account+method+path. Same key/body returns same
+     * outcome; changed body 409; in-progress 409 with Retry-After. Token-create replay
+     * returns 200 metadata WITHOUT secret.
+     */
+    'Idempotency-Key': string;
+    /**
+     * Header param: Exact quoted resource-version ETag; an exact intermediary-weakened
+     * echo W/"n" is accepted. Wildcard, combined and malformed validators are
+     * rejected; stale 412; missing 428. HTTP field names are case-insensitive.
+     * Replayed idempotent result is checked first.
+     */
+    'If-Match': string;
+    /**
+     * Body param
+     */
+    allowed_models?: Array<string> | null;
+    /**
+     * Body param
+     */
+    blocked?: boolean;
+    /**
+     * Body param
+     */
+    budget_duration?: TokenGroupsAPI.BudgetDuration | null;
+    /**
+     * Body param
+     */
+    expires_at?: string | null;
+    /**
+     * Body param: USD, decimal precision at most 6 places; parse exactly to integer
+     * micro-USD, never binary float accounting.
+     */
+    max_budget?: number | null;
+    /**
+     * Body param: Optional maximum concurrent reserved/dispatched cache misses across
+     * replicas. Null means no concurrency cap. Cache hits do not consume slots;
+     * unknown usage retains its budget hold without a slot.
+     */
+    max_parallel_requests?: number | null;
+    /**
+     * Body param
+     */
+    name?: string;
+    /**
+     * Body param: Require a nonempty caller-asserted end-user ID; not proof of
+     * identity. Omission preserves the current requirement.
+     */
+    required_end_user_id?: boolean;
+    /**
+     * Body param: Omitted or null defaults to the maximum (6000) (on a blocked key,
+     * null is kept until the key is unblocked); a value below the minimum (1) or above
+     * the maximum is rejected with 400 limit_out_of_range; a malformed value
+     * (negative, wrong type or precision) is 400 invalid_request. Block the key
+     * (blocked: true) to deny it; blocking is always accepted.
+     */
+    rpm_limit?: number | null;
+    /**
+     * Body param: Omitted or null defaults to the maximum (10000000) (on a blocked
+     * key, null is kept until the key is unblocked); a value below the minimum (1) or
+     * above the maximum is rejected with 400 limit_out_of_range; a malformed value
+     * (negative, wrong type or precision) is 400 invalid_request. Block the key
+     * (blocked: true) to deny it; blocking is always accepted.
+     */
+    tpm_limit?: number | null;
+}
+export declare namespace TokenKeys {
+    export { type TokenKey as TokenKey, type TokenKeyResponse as TokenKeyResponse, type TokenKeysDefaultFlatPagination as TokenKeysDefaultFlatPagination, type TokenKeyListParams as TokenKeyListParams, type TokenKeyCreateParams as TokenKeyCreateParams, type TokenKeyDeleteParams as TokenKeyDeleteParams, type TokenKeyUpdateParams as TokenKeyUpdateParams, };
+}
+//# sourceMappingURL=token-keys.d.ts.map

package/resources/llm-token-gateway/token-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-keys.d.ts","sourceRoot":"","sources":["../../src/resources/llm-token-gateway/token-keys.ts"],"names":[],"mappings":"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"}

package/resources/llm-token-gateway/token-keys.js

@@ -0,0 +1,127 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenKeys = void 0;
+const resource_1 = require("../../core/resource.js");
+const pagination_1 = require("../../core/pagination.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+/**
+ * Manage and report AI Gateway usage.
+ */
+class TokenKeys extends resource_1.APIResource {
+    /**
+     * List gateway token keys within the authenticated Telnyx account. Foreign and
+     * unknown resource IDs return the same 404 response.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const tokenKey of client.llmTokenGateway.tokenKeys.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/llm_token_gateway/token_keys', (pagination_1.DefaultFlatPagination), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Create gateway token key within the authenticated Telnyx account. Foreign and
+     * unknown resource IDs return the same 404 response. The token secret is returned
+     * only on the original create response. A replay returns metadata without the
+     * secret. Provisioning is advisory; ready is not a guarantee of inference
+     * availability.
+     *
+     * @example
+     * ```ts
+     * const tokenKeyResponse =
+     *   await client.llmTokenGateway.tokenKeys.create({
+     *     name: 'support-service',
+     *     token_group_id: '11111111-1111-4111-8111-111111111111',
+     *     'Idempotency-Key': 'Idempotency-Key',
+     *     max_parallel_requests: 5,
+     *   });
+     * ```
+     */
+    create(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/llm_token_gateway/token_keys', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ 'Idempotency-Key': idempotencyKey }, options?.headers]),
+        });
+    }
+    /**
+     * Revoke this token key. Acknowledged revocation blocks new admissions with the
+     * key; requests already admitted may complete. Historical usage attribution is
+     * retained. Other keys in the group are unchanged.
+     *
+     * @example
+     * ```ts
+     * await client.llmTokenGateway.tokenKeys.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   {
+     *     'Idempotency-Key': 'Idempotency-Key',
+     *     'If-Match': 'If-Match',
+     *   },
+     * );
+     * ```
+     */
+    delete(id, params, options) {
+        const { 'Idempotency-Key': idempotencyKey, 'If-Match': ifMatch } = params;
+        return this._client.delete((0, path_1.path) `/llm_token_gateway/token_keys/${id}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { Accept: '*/*', 'Idempotency-Key': idempotencyKey, 'If-Match': ifMatch },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Get gateway token key within the authenticated Telnyx account. Foreign and
+     * unknown resource IDs return the same 404 response.
+     *
+     * @example
+     * ```ts
+     * const tokenKeyResponse =
+     *   await client.llmTokenGateway.tokenKeys.retrieve(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get((0, path_1.path) `/llm_token_gateway/token_keys/${id}`, options);
+    }
+    /**
+     * Update gateway token key within the authenticated Telnyx account. Foreign and
+     * unknown resource IDs return the same 404 response. Omitted fields are preserved.
+     * Null clears max_parallel_requests; null resets budget and rate limits to their
+     * maximum. A stale If-Match returns 412.
+     *
+     * @example
+     * ```ts
+     * const tokenKeyResponse =
+     *   await client.llmTokenGateway.tokenKeys.update(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     {
+     *       'Idempotency-Key': 'Idempotency-Key',
+     *       'If-Match': 'If-Match',
+     *       max_parallel_requests: 5,
+     *     },
+     *   );
+     * ```
+     */
+    update(id, params, options) {
+        const { 'Idempotency-Key': idempotencyKey, 'If-Match': ifMatch, ...body } = params;
+        return this._client.patch((0, path_1.path) `/llm_token_gateway/token_keys/${id}`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ 'Idempotency-Key': idempotencyKey, 'If-Match': ifMatch }, options?.headers]),
+        });
+    }
+}
+exports.TokenKeys = TokenKeys;
+//# sourceMappingURL=token-keys.js.map

package/resources/llm-token-gateway/token-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-keys.js","sourceRoot":"","sources":["../../src/resources/llm-token-gateway/token-keys.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,yDAA6G;AAC7G,uDAAsD;AAEtD,uDAAiD;AAEjD;;GAEG;AACH,MAAa,SAAU,SAAQ,sBAAW;IACxC;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,+BAA+B,EAAE,CAAA,kCAA+B,CAAA,EAAE;YAC/F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,MAA4B,EAAE,OAAwB;QAC3D,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE;YACxD,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SACjF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,EAAU,EAAE,MAA4B,EAAE,OAAwB;QACvE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC1E,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,iCAAiC,EAAE,EAAE,EAAE;YACpE,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE;gBACzE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,iCAAiC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,EAAU,EAAE,MAA4B,EAAE,OAAwB;QACvE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACnF,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,iCAAiC,EAAE,EAAE,EAAE;YACnE,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SACtG,CAAC,CAAC;IACL,CAAC;CACF;AAxHD,8BAwHC"}

package/resources/llm-token-gateway/token-keys.mjs

@@ -0,0 +1,123 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { DefaultFlatPagination } from "../../core/pagination.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { path } from "../../internal/utils/path.mjs";
+/**
+ * Manage and report AI Gateway usage.
+ */
+export class TokenKeys extends APIResource {
+    /**
+     * List gateway token keys within the authenticated Telnyx account. Foreign and
+     * unknown resource IDs return the same 404 response.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const tokenKey of client.llmTokenGateway.tokenKeys.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/llm_token_gateway/token_keys', (DefaultFlatPagination), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Create gateway token key within the authenticated Telnyx account. Foreign and
+     * unknown resource IDs return the same 404 response. The token secret is returned
+     * only on the original create response. A replay returns metadata without the
+     * secret. Provisioning is advisory; ready is not a guarantee of inference
+     * availability.
+     *
+     * @example
+     * ```ts
+     * const tokenKeyResponse =
+     *   await client.llmTokenGateway.tokenKeys.create({
+     *     name: 'support-service',
+     *     token_group_id: '11111111-1111-4111-8111-111111111111',
+     *     'Idempotency-Key': 'Idempotency-Key',
+     *     max_parallel_requests: 5,
+     *   });
+     * ```
+     */
+    create(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/llm_token_gateway/token_keys', {
+            body,
+            ...options,
+            headers: buildHeaders([{ 'Idempotency-Key': idempotencyKey }, options?.headers]),
+        });
+    }
+    /**
+     * Revoke this token key. Acknowledged revocation blocks new admissions with the
+     * key; requests already admitted may complete. Historical usage attribution is
+     * retained. Other keys in the group are unchanged.
+     *
+     * @example
+     * ```ts
+     * await client.llmTokenGateway.tokenKeys.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   {
+     *     'Idempotency-Key': 'Idempotency-Key',
+     *     'If-Match': 'If-Match',
+     *   },
+     * );
+     * ```
+     */
+    delete(id, params, options) {
+        const { 'Idempotency-Key': idempotencyKey, 'If-Match': ifMatch } = params;
+        return this._client.delete(path `/llm_token_gateway/token_keys/${id}`, {
+            ...options,
+            headers: buildHeaders([
+                { Accept: '*/*', 'Idempotency-Key': idempotencyKey, 'If-Match': ifMatch },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Get gateway token key within the authenticated Telnyx account. Foreign and
+     * unknown resource IDs return the same 404 response.
+     *
+     * @example
+     * ```ts
+     * const tokenKeyResponse =
+     *   await client.llmTokenGateway.tokenKeys.retrieve(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get(path `/llm_token_gateway/token_keys/${id}`, options);
+    }
+    /**
+     * Update gateway token key within the authenticated Telnyx account. Foreign and
+     * unknown resource IDs return the same 404 response. Omitted fields are preserved.
+     * Null clears max_parallel_requests; null resets budget and rate limits to their
+     * maximum. A stale If-Match returns 412.
+     *
+     * @example
+     * ```ts
+     * const tokenKeyResponse =
+     *   await client.llmTokenGateway.tokenKeys.update(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     {
+     *       'Idempotency-Key': 'Idempotency-Key',
+     *       'If-Match': 'If-Match',
+     *       max_parallel_requests: 5,
+     *     },
+     *   );
+     * ```
+     */
+    update(id, params, options) {
+        const { 'Idempotency-Key': idempotencyKey, 'If-Match': ifMatch, ...body } = params;
+        return this._client.patch(path `/llm_token_gateway/token_keys/${id}`, {
+            body,
+            ...options,
+            headers: buildHeaders([{ 'Idempotency-Key': idempotencyKey, 'If-Match': ifMatch }, options?.headers]),
+        });
+    }
+}
+//# sourceMappingURL=token-keys.mjs.map

package/resources/llm-token-gateway/token-keys.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-keys.mjs","sourceRoot":"","sources":["../../src/resources/llm-token-gateway/token-keys.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAGlD,OAAO,EAAE,qBAAqB,EAAiD,kCAA8B;AAC7G,OAAO,EAAE,YAAY,EAAE,mCAA+B;AAEtD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,+BAA+B,EAAE,CAAA,qBAA+B,CAAA,EAAE;YAC/F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,MAA4B,EAAE,OAAwB;QAC3D,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE;YACxD,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SACjF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,EAAU,EAAE,MAA4B,EAAE,OAAwB;QACvE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC1E,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,iCAAiC,EAAE,EAAE,EAAE;YACpE,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE;gBACzE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,iCAAiC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,EAAU,EAAE,MAA4B,EAAE,OAAwB;QACvE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACnF,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,iCAAiC,EAAE,EAAE,EAAE;YACnE,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SACtG,CAAC,CAAC;IACL,CAAC;CACF"}