---
title: "Get the Agent Allow list"
method: GET
path: "/v1/agents/{agentId}/allowlist"
tags: ["Agents"]
---

# Get the Agent Allow list

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

Get the list of projects the Agent is restricted to only when the agent has the property `restrictedAccess` set to true.

If `restrictedAccess` is set to true and the list of projects is empty, then the Agent will not be applicable to be assigned to any project.

If `restrictedAccess` is set to false for the Agent, then restriction to these projects will not be enforced.

## Path parameters

- `agentId` string, required

## Response `200`

Agent allow list successfully retrieved

- AgentAccessResponse
  - `projects` object, required — The list of projects the Agent is scoped to. Each project will be displayed as an object with the Project ID as the key.

## Other responses

- `400` — Invalid request parameters 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/versions/6239825f68eb/schema)