Skip to main content
POST
Create a new collection

Authorizations

Authorization
string
header
required

JWT token passed in authorization header

Body

application/json
name
string
required
institution
string

Digital Twin id for a root collection: a 24-character id string (anything else is refused with 400). Ignored under a parent, whose vault the new collection inherits.

account_shared
boolean

Root collections with an institution only. Read strictly: true, 'true', 1, '1' or 'yes' share it; the string 'false' does not.

parent
string

Parent collection ID (optional, creates sub-collection)

color
string | null

Optional accent color (#RGB / #RRGGBB) applied to the folder icon.

Pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
Example:

"#10b981"

Response

Collection created