Skip to main content
POST
Create a folder
When to use: to organize projects. Side effects: None beyond the new folder. Cost: Free. Idempotency: Idempotency-Key accepted (SDKs send one); retries within 24 h replay the first response. Required scopes: projects:write

Authorizations

Authorization
string
header
required

API key from Settings -> API keys, sent as Authorization: Bearer <key> (SDK environment variable RASK_API_KEY). Bound to one workspace and one acting user. Operations list the scopes they need (OpenAPI 3.1 scopes on a bearer scheme).

Scopes

projects:write

Headers

Idempotency-Key
string

Optional. A unique key per logical request (SDKs send a bare UUIDv4; an RFC 9651 quoted string is accepted and unquoted); reuse it unchanged on retries to replay the first response.

Required string length: 1 - 255
Pattern: ^[\x20-\x7E]+$

Body

application/json

Body of createFolder.

name
string
required

Folder name.

Required string length: 1 - 255
is_pinned
boolean
default:false

Pin the folder in the web app.

Response

Created: Folder.

A project folder.

object
enum<string>
required

Always folder.

Available options:
folder
id
string
required

Folder id.

name
string
required

Folder name.

is_pinned
boolean
required

Pinned in the web app.

project_count
integer<int32>
required

Live projects in the folder.

created_at
string<date-time>
required

Creation time.