Skip to content

Create a Collection

Creates a new collection in a project.

POST /api/projects/{projectId}/collections

Request body

{
"name": "Products",
"slug": "products",
"description": "Product catalog",
"isSingleton": false,
"fields": [
{ "name": "Name", "slug": "name", "type": "text", "isRequired": true },
{ "name": "Price", "slug": "price", "type": "decimal", "isRequired": true },
{ "name": "Description", "slug": "description", "type": "richtext" },
{ "name": "Image", "slug": "image", "type": "media" }
]
}

Response

{
"uuid": "coll-uuid",
"name": "Products",
"slug": "products",
"description": "Product catalog",
"is_singleton": false,
"fields": [
{ "name": "Name", "slug": "name", "type": "text", "required": true, "order": 1 },
{ "name": "Price", "slug": "price", "type": "decimal", "required": true, "order": 2 }
]
}

Status codes

StatusDescription
201Created
409A collection with this slug already exists
422Validation error