POST /v1/objects
Create a new object by sending a JSON request body.
POST /v1/objects creates a new object.
Authentication
Send an organization API key in x-api-key or
Authorization: Bearer <key>.
Request Body
Send a JSON object with the target collection and design. name is optional
and can be null.
| Name | Type | Required | Description |
|---|---|---|---|
collectionId | string (uuid) | Yes | UUID of the collection that owns the object. |
designId | string (uuid) | Yes | UUID of the design used by the object. |
name | string or null | No | Initial object name. |
Example
curl -X POST "https://api.blueputto.com/v1/objects" \
-H "x-api-key: YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{"collectionId":"COLLECTION_ID","designId":"DESIGN_ID","name":"Chair"}'Success Response
201 Created
{
"data": {}
}Error Responses
400 Bad Request401 Unauthorized404 Not Found429 Too Many Requests