Update Status
PATCH
/statuses/1
Authentication
statuses:writePath Parameters
| Parameter | Type | Description |
|---|---|---|
id | integer | Required. The status ID to update |
Request Body
| Field | Type | Required | Validation | Description |
|---|---|---|---|---|
name | string | Yes | max:255, unique per tenant (excludes current status) | Status name |
color | string | No | max:7, hex format #RRGGBB (regex: /^#[0-9A-Fa-f]{6}$/) | Display color |
Response
message: "Status updated successfully".Error Responses
| Status | Code | Description |
|---|---|---|
| 404 | NOT_FOUND | Status not found |
| 422 | VALIDATION_ERROR | Validation failed |
| 500 | INTERNAL_ERROR | Failed to update status |
Validation Error Messages
| Field | Message |
|---|---|
name | Status name is required / A status with this name already exists |
color | Color must be a valid hex color code (e.g., #FF5733) |
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH '/statuses/1' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Updated Status Name",
"color": "#00FF00"
}'Response Response Example
{}Modified at 2026-02-25 01:06:20