POST /v1/statuses
Create a new status by sending a JSON request body.
POST /v1/statuses creates a new status.
Authentication
Send an organization API key in x-api-key or
Authorization: Bearer <key>.
Request Body
name, color, and type are required.
| Name | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Status name, from 1 to 100 characters. |
color | string | Yes | Status color, from 1 to 50 characters. |
type | enum | Yes | One of in-storage, on-display, temporarily-unavailable, or offsite. |
description | string | No | Status description, up to 500 characters. |
Example
curl -X POST "https://api.blueputto.com/v1/statuses" \
-H "x-api-key: YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{"name":"On display","color":"#16a34a","type":"on-display"}'Success Response
201 Created
{
"data": {}
}Error Responses
400 Bad Request401 Unauthorized429 Too Many Requests