---
title: "Update Agent Group"
method: PATCH
path: "/api/v1/agent-groups/{agentGroupId}"
---

# Update Agent Group

`PATCH /api/v1/agent-groups/{agentGroupId}`

## Request

- Base URL: `https://api.skyfire.xyz`
- URL: `https://api.skyfire.xyz/api/v1/agent-groups/{agentGroupId}`
- Auth: API key in header `skyfire-api-key`

As an Organization Admin, rename, describe, deactivate, or reactivate an agent group in your organization.

## Path parameters

- `agentGroupId` string, uuid, required

## Request body

- object
  - `name` string: New name for the group and all of its active member agents. Same rules as on creation.
  - `description` string, nullable: New description. Send `null` to clear it.
  - `active` boolean: `false` pauses the group: no member can obtain a token and no user can be enrolled until it is reactivated. `true` reactivates it. Member agents are not modified.

## Response `200`

Ok

- object
  - `id` string, required: Unique identifier of the agent group.
  - `name` string, required: The group's name after the update.
  - `description` string, nullable, required: The group's description after the update, or `null`.
  - `active` boolean, required: Whether the group is active after the update.
  - `createdAt` string, required: When the group was created.
  - `updatedAt` string, required: When the group was last changed.

## Other responses

- `401`: Unauthorized
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Entity

## Changes

- **2026-11-03** `22cbec9d7630`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis/changes/api/v1/agent-groups/:agentGroupId/patch.md)

---

[API](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis.md) - [All operations](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis/revisions/22cbec9d7630?raw)