Skip to main content
POST
/
v1
/
folders
Create folder
curl --request POST \
  --url https://api.uselora.com/v1/folders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "accessLevel": "workspace",
  "teamId": "<string>",
  "description": "<string>"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "slug": "<string>",
  "description": "<string>",
  "isSystem": true,
  "workspaceId": "<string>",
  "creatorId": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://uselora.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Payload to create a new folder

​
name
string
required

The folder name (3..190 chars). The slug is derived from this server-side.

Required string length: 3 - 190
Example:

"Marketing"

​
accessLevel
enum<string>
default:workspace
required

Who can see this folder? Defaults to "workspace" (visible to everyone). "none" means invite-only.

Available options:
workspace,
team,
none
Example:

"workspace"

​
teamId
string | null

When accessLevel is "team", the team this folder is scoped to. Optional.

​
description
string | null

Optional description for the folder

Response

The created folder.

A folder.

​
id
string
required

Stable 8-char Crockford-base32 handle (no i/l/o/u). Use this in URL paths and to address the folder via the API.

Pattern: ^[0-9abcdefghjkmnpqrstvwxyz]{8}$
Example:

"a1b2c3d4"

​
name
string
required
​
slug
string
required
​
description
string | null
required
​
accessLevel
enum<string>
required
Available options:
workspace,
team,
none
​
isSystem
boolean
required

True for built-in folders such as the workspace default. Folders you create are always false.

​
workspaceId
string
required

ID of the workspace the folder belongs to.

​
creatorId
string
required

ID of the user who created the folder.

​
createdAt
string
required

ISO 8601 creation timestamp.

​
updatedAt
string
required

ISO 8601 timestamp of the last update.