---
title: "Remove project from Agent Allow list"
method: DELETE
path: "/v1/agents/{agentId}/allowlist"
tags: ["Agents"]
---

# Remove project from Agent Allow list

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

Removes the specified project or environment from the allowed access list of the defined agent.

If an environmentName is supplied, then this will be removed, but the project will remain in the Agent's Allow List. If no environmentName is supplied, then the project (and any associated environments) will be removed from the Agent's Allow list.

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

## Path parameters

- `agentId` string, required

## Query parameters

- `projectId` string, uuid, required
- `environmentName` string

## Response `202`

Project and/or environment successfully removed from Agent Allow list

## Other responses

- `400` — Wrong 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)
