Skip to main content
POST
Create a Semantic Layer folder
Send parent to create the folder inside another one, or omit it (or send null) to create it at the root. Folder names are unique among siblings: a taken name answers 400, so check the name first when it may collide.
Who may create depends on the key: A folder a service account creates is added to its own scope, so it can keep working in it: a folder it creates at the root becomes part of its selection.

Authorizations

x-api-key
string
header
required

API Key authentication. Format: 'x-api-key: api_key'

Body

name
string
required
Maximum string length: 256
description
string | null
icon
string | null
Maximum string length: 256
hidden
boolean

Frontend-only: hides the folder from the tree, still reachable in the details view. The backend does not filter on it, except in the pins listing.

parent
string<uuid> | null

Parent folder. Omit or send null to create at the root.

Response

201 - application/json
id
string<uuid>
required
read-only
name
string
required
Maximum string length: 256
slug
string
required
read-only
order
integer | null
required
read-only
created_by
integer | null
required
read-only
created_at
string<date-time>
required
read-only
updated_at
string<date-time>
required
read-only
description
string | null
icon
string | null
Maximum string length: 256
hidden
boolean

Frontend-only: hides the folder from the tree, still reachable in the details view. The backend does not filter on it, except in the pins listing.

parent
string<uuid> | null

Parent folder. Omit or send null to create at the root.