Attach a policy

Applies a policy to every request, or to the requests for the models named. It applies from the next request on.

POST /agent_gateways/{instance_id}/policy_attachments

JavaScript

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const AgentGatewayPolicyAttachment = await client.agentGateways.policyAttachments.create('instance_id', {
  policy: 'policy',
});

console.log(AgentGatewayPolicyAttachment.data);

201

{
  "data": {
    "id": "3394712f-2ad5-428a-8a3d-7a08d4b2906d",
    "policy": "strict",
    "models": [
      "GLM-5.3*"
    ],
    "priority": 10,
    "default": false,
    "created_at": "2026-11-02T12:58:55.388000Z",
    "updated_at": "2026-11-02T12:58:55.388000Z"
  }
}

Authorizations

Authorization · string · header · required

Telnyx API key

Path Parameters

instance_id · string<uuid> · required

The Agent Gateway's id.

Body

application/json

policy · string · required

The policy to apply, by name.

models · string[]

The models whose requests the policy applies to, by name. A name can use * as a wildcard. Empty applies the policy to every request.

priority · integer | null

An attachment with a priority applies before the others.

default · boolean · default: false

true applies the policy only to the requests no other attachment matches.

Response

201

application/json

The attachment

data · object · required

Where an instance applies a policy.

Show child attributes