Developer API
Update Staff Role
Change a staff member's role.
PATCH /v1/minecraft/staff/{id}/role
Change the role assigned to a staff member. The new role must be a valid role that exists in the server's role configuration.
Authentication
Requires the X-API-Key header with your server's API key.
X-API-Key: your-api-key-hereRequest
Headers
| Header | Type | Required | Description |
|---|---|---|---|
X-API-Key | string | Yes | Your server's API key. |
Content-Type | string | Yes | Must be application/json. |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The unique identifier of the staff member. |
Body
| Field | Type | Required | Description |
|---|---|---|---|
role | string | Yes | The name of the new role to assign to the staff member. |
{
"role": "Admin"
}Response
200 OK
{
"success": true,
"message": "Staff role updated successfully."
}Error Responses
| Status Code | Description |
|---|---|
400 | Invalid role name. The specified role does not exist. |
401 | Missing or invalid API key. |
404 | Staff member not found. |
429 | Rate limit exceeded. |
500 | Internal server error. |