---
title: permission_set_update
url: "/docs/ai-agents/mcp-tools/permission-sets/permission_set_update/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/permission-sets/permission_set_update/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/permission-sets/permission_set_update.md
summary: Change a Permission Set's name, description, access mode or scopes.
categories:
- mcp
- reference
---

# permission_set_update

Change a Permission Set's name, description, access mode or scopes. Members and tokens using it change too.

| | |
|---|---|
| Access | Changes Blossom |
| Same as | [`blossom permission_set:update`](/docs/reference/cli/permission_set/update/) |

## Arguments

| Argument | Type | Description |
|---|---|---|
| `id` | string | Permission Set id. Required. |
| `data` | object | Only the fields to change. Required. |
| `data.name` | string | Name. |
| `data.description` | string | What it is for. |
| `data.access_mode` | string | custom, the only mode a saved Permission Set uses. |
| `data.scopes` | string list | Custom permission scopes; permission_set_scopes lists them. |

## Example

```json
{"id":"permission_set-100","data":{"clone_url":"https://github.com/acme/shop","services":[{"name":"web","command":"web","port":3000,"publicly_exposed":true}]}}
```