---
title: "Set Agent Allow List"
method: PUT
path: "/v1/agents/{agentId}/allowlist"
tags: ["Agents"]
---

# Set Agent Allow List

`PUT /v1/agents/{agentId}/allowlist`

Set the list of projects the Agent will be restricted to only when the agent has the property `restrictedAccess` set to true. If projects are empty, this will remove all projects the agent is restricted to, effectively making the agent inaccessible to any project when the agent property has `restrictedAccess` set to true.

Please keep in mind that by using endpoint you are setting the allow list and so this will overwrite any previously set values, if you want to simply update the existing allow list please refer to the PATCH endpoint.

NOTE: Whilst the Agent property `restrictedAccess` is set to false, any amendments will not be enforced until `restrictedAccess` is set to true.

## Path parameters

- `agentId` string, required

## Request body

- SetAgentAccessRequest
  - `projects` object, required — The list of projects the Agent is allowed to be scoped to. Each project should be provided as an object with the Project ID, or the list can be left empty.

## Response `202`

Agent allow list successfully updated

## Other responses

- `400` — Invalid request body used
- `403` — Forbidden
- `404` — Agent not found
- `500` — Unexpected error occurred

---

[API](https://skmtc.net/maia/apis/maia-public-rest-api.md) · [All operations](https://skmtc.net/maia/apis/maia-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia/maia-public-rest-api/revisions/6239825f68eb/schema)