Folder - Creates a new folder in the specified workspace

Creates a new folder in the specified workspace.

post

Authorizations

Bearer

HTTPRequired

Please enter a valid token

Path parameters

tenantIdstring · uuidRequired

The unique identifier of the workspace where the folder will be created.

Query parameters

versionstringOptional

The requested API version

Default: 1.0

Header parameters

embedfast-user-idstringOptional

Optional User Id

Body

application/jsontext/jsonapplication/*+json

Represents a request to create a new folder.

namestring · nullableOptional

The name of the folder to be created.

descriptionstring · nullableOptional

The description of the folder.

Responses

201

Created: The folder was successfully created.

text/plainapplication/jsontext/json

Represents the response containing folder details.

idstring · uuidOptional

The unique identifier of the folder.

namestring · nullableOptional

The name of the folder.

descriptionstring · nullableOptional

The description of the folder.

createdDatestring · date-timeOptional

The date and time when the folder was created.

modifiedDatestring · date-timeOptional

The date and time when the folder was last modified.

400

Bad Request: The request is invalid.

text/plainapplication/jsontext/json

401

Unauthorized: Access token is missing or invalid.

text/plainapplication/jsontext/json

403

Forbidden: Permission denied to create the folder.

text/plainapplication/jsontext/json

500

Internal Server Error: An unexpected error occurred or a server timeout.

text/plainapplication/jsontext/json

post

/tenants/{tenantId}/folders/createFolder

HTTPcURLJavaScriptPython

POST /tenants/{tenantId}/folders/createFolder HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "name": "text",
  "description": "text"
}

application/jsontext/jsonapplication/*+json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "createdDate": "2026-02-23T01:58:24.039Z",
  "modifiedDate": "2026-02-23T01:58:24.039Z"
}