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
curl --request POST \
--url https://api.telnyx.com/v2/agent_gateways/{instance_id}/policy_attachments \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"policy": "strict",
"models": [
"GLM-5.3*"
],
"priority": 10
}
'{
"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"
}
}{
"errors": [
{
"code": "10013",
"title": "Missing association",
"detail": "One of the associated fields does not exist.",
"meta": {
"url": "https://developers.telnyx.com/docs/overview/errors/10013"
},
"source": {
"pointer": "/policy"
}
}
]
}{
"errors": [
{
"code": "10009",
"title": "Authentication failed",
"detail": "The required authentication headers were either invalid or not included in the request.",
"meta": {
"url": "https://developers.telnyx.com/docs/overview/errors/10009"
}
}
]
}{
"errors": [
{
"code": "10005",
"title": "Resource not found",
"detail": "The requested resource or URL could not be found.",
"meta": {
"url": "https://developers.telnyx.com/docs/overview/errors/10005"
}
}
]
}Authorizations
Telnyx API key
Path Parameters
The Agent Gateway's id.
Body
application/json
The policy to apply, by name.
The models whose requests the policy applies to, by name. A name can use * as a wildcard. Empty applies the policy to every request.
An attachment with a priority applies before the others.
true applies the policy only to the requests no other attachment matches.
Response
The attachment
Where an instance applies a policy.
Show child attributes
Show child attributes
Was this page helpful?
curl --request POST \
--url https://api.telnyx.com/v2/agent_gateways/{instance_id}/policy_attachments \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"policy": "strict",
"models": [
"GLM-5.3*"
],
"priority": 10
}
'{
"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"
}
}{
"errors": [
{
"code": "10013",
"title": "Missing association",
"detail": "One of the associated fields does not exist.",
"meta": {
"url": "https://developers.telnyx.com/docs/overview/errors/10013"
},
"source": {
"pointer": "/policy"
}
}
]
}{
"errors": [
{
"code": "10009",
"title": "Authentication failed",
"detail": "The required authentication headers were either invalid or not included in the request.",
"meta": {
"url": "https://developers.telnyx.com/docs/overview/errors/10009"
}
}
]
}{
"errors": [
{
"code": "10005",
"title": "Resource not found",
"detail": "The requested resource or URL could not be found.",
"meta": {
"url": "https://developers.telnyx.com/docs/overview/errors/10005"
}
}
]
}