> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bedrock.quarry-systems.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Role

> Update an existing role

## Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the role to update
</ParamField>

## Request Body

<ParamField body="name" type="string">
  Updated display name for the role
</ParamField>

<ParamField body="description" type="string">
  Updated description of the role
</ParamField>

## Response

Returns the updated role object.

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH 'https://api.example.com/roles/role_123' \
    -H 'Authorization: Bearer YOUR_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
      "name": "Senior Editor",
      "description": "Can edit, publish, and manage content"
    }'
  ```

  ```javascript Node.js theme={null}
  const axios = require('axios');

  const { data } = await axios.patch('https://api.example.com/roles/role_123', {
    name: 'Senior Editor',
    description: 'Can edit, publish, and manage content',
  }, {
    headers: { 'Authorization': 'Bearer YOUR_TOKEN' },
  });
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "role_123",
    "name": "Senior Editor",
    "description": "Can edit, publish, and manage content",
    "scopeId": "scope_456"
  }
  ```
</ResponseExample>