---
title: "Replace Agent Scopes"
method: PUT
path: "/agents/{agent_id}/scopes"
tags: ["Agents"]
---

# Replace Agent Scopes

`PUT /agents/{agent_id}/scopes`

Replace all scopes for an agent.

## Path parameters

- `agent_id` string, required

## Request body

- AgentScopesRequest — Request body for replacing an agent's scopes.
  - `scopes` string[], required

## Response `200`

Successful Response

- AgentScopesResponse — Response containing an agent's current scopes.
  - `scopes` string[], required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/jentic/apis/jentic-control-plane-api.md) · [All operations](https://skmtc.net/jentic/apis/jentic-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jentic/jentic-control-plane-api/versions/ff371f19960a/schema)