Skip to main content
PATCH
Update access list
Update an access list’s name, allowed models, or auto-approve setting. name and auto_approve are optional and only change when you include them.
The model fields replace the whole model list. This is a set operation, not an add. If the request includes any model field (chat, decision, embedding, image, transcription, speech), the access list ends up with exactly the models you send, and every modality you leave out is cleared.For example, sending only chat to a list that also has embedding models removes the embedding models.
To add or remove a few models, first fetch the list with Get Access List, edit the arrays, then send all modalities back:
A request with no model fields (for example only name) leaves the models unchanged.

Authorizations

Authorization
string
header
required

API key for authentication

Path Parameters

access_list_id
string<uuid>
required

The access list ID

Body

application/json

All fields are optional. name and auto_approve only change when included. The model fields replace the whole model list: if any model field is included, every modality not included is cleared. Send all modalities to keep them.

name
string

New name for the access list

auto_approve
boolean

Whether new models matching the list patterns are automatically approved

chat
string[]

Allowed chat/completion model identifiers. Replaces the current list; if any model field is sent and this one is omitted, it is cleared

embedding
string[]

Allowed embedding model identifiers. Replaces the current list; if any model field is sent and this one is omitted, it is cleared

image
string[]

Allowed image generation model identifiers. Replaces the current list; if any model field is sent and this one is omitted, it is cleared

transcription
string[]

Allowed transcription model identifiers. Replaces the current list; if any model field is sent and this one is omitted, it is cleared

speech
string[]

Allowed speech model identifiers. Replaces the current list; if any model field is sent and this one is omitted, it is cleared

decision
string[]

Allowed decision model identifiers. Replaces the current list; if any model field is sent and this one is omitted, it is cleared

Response

Access list updated successfully

Last modified on October 8, 2026