This endpoint is used to create a collection for a user

POST/api/collections/create

Authorization

AuthorizationBearer token (JWT) · headerrequired

Header parameters

x-organization-idstring

Target organization id. Defaults to the caller's personal organization when omitted.

Request body

requiredapplication/json

titlestringrequired

The title of the collection (letters and spaces only)

Responses

201Created

any

400Bad Request

any

500Internal Server Error

any

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (JWT)Remember on this deviceInclude my values in samples

Parameters

x-organization-idheaderTarget organization id. Defaults to the caller's personal organization when omitted.

Bodyapplication/json

titlestring*The title of the collection (letters and spaces only)

Request

curl -X POST "http://localhost:8000/api/collections/create" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "My TALA Collection"
}'

const response = await fetch("http://localhost:8000/api/collections/create", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"title\": \"My TALA Collection\"\n}"
});

Response

{
  "id": "CLb2Nk6x8R",
  "title": "My Collection",
  "userId": "CRa7Bk9x2Q"
}

{
  "message": "Collection title is required",
  "error": "Bad Request",
  "statusCode": 400
}

{
  "message": "Something went wrong",
  "error": "Internal Server Error",
  "statusCode": 500
}