POST /v1/collections
Create a new collection by sending a JSON request body.
POST /v1/collections creates a new collection.
Authentication
Send an organization API key in x-api-key or
Authorization: Bearer <key>.
Request Body
name is required. All other fields are optional.
| Name | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Collection name, from 1 to 100 characters. |
description | string or null | No | Description, up to 4,000 characters. |
teamIds | array of strings | No | Up to 100 teams allowed to access the collection. Defaults to an empty array. |
isPubliclyVisible | boolean | No | Whether the collection is visible on the public website. Defaults to false. |
Example
curl -X POST "https://api.blueputto.com/v1/collections" \
-H "x-api-key: YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{"name":"Sculpture collection","isPubliclyVisible":true}'Success Response
201 Created
{
"data": {}
}Error Responses
400 Bad Request401 Unauthorized404 Not Found429 Too Many Requests