Create Status
POST
/statuses
Authentication
statuses:writeRequest Body
| Field | Type | Required | Validation | Description |
|---|---|---|---|---|
name | string | Yes | max:255, unique per tenant | Status name |
color | string | No | max:7, hex format #RRGGBB (regex: /^#[0-9A-Fa-f]{6}$/) | Display color |
Response
message: "Status created successfully".Response Fields
| Field | Type | Description |
|---|---|---|
id | integer | Status ID |
name | string | Status name |
color | string|null | Hex color code |
created_at | string | ISO 8601 datetime |
updated_at | string | ISO 8601 datetime |
Error Responses
| Status | Code | Description |
|---|---|---|
| 422 | VALIDATION_ERROR | Validation failed |
| 500 | INTERNAL_ERROR | Failed to create 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 POST '/statuses' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Hot Lead",
"color": "#FF5733"
}'Response Response Example
{}Modified at 2026-02-25 01:06:20