Skip to main content
POST
Create a new folder

Authorizations

x-api-key
string
header
required

API Key for server-to-server authentication. Resolves to the owning organization.

Body

application/json
name
string
required

Folder name

parentFolderId
string

Parent folder ID

description
string

Folder description

metadata
object

Additional metadata

Response

201 - application/json

Folder created successfully

_id
string
required

Folder ID

name
string
required

Folder name

organizationId
string
required

Organization ID

status
enum<string>
required

Folder status

Available options:
active,
deleted
createdAt
string<date-time>
required

Creation date

updatedAt
string<date-time>
required

Last update date

parentFolderId
string | null

Parent folder ID

description
string

Folder description

metadata
object

Folder metadata