Skip to main content
POST
Set the default folder

Authorizations

Authorization
string
header
required

Workspace API key, sent as Authorization: Bearer lk_live_….

Body

application/json
folderId
string<uuid> | null
required

Response

object | null

The new default folder, or null when the default was cleared.

id
string<uuid>
name
string
Example:

"Paid campaigns"

color
string | null
Example:

"#f97316"

isDefault
boolean

New links land here when no folderId is sent.

isSystem
boolean

System folders cannot be renamed or deleted.

isActive
boolean
parentId
string<uuid> | null

Present on the model but unused — folders are flat in practice.

workspaceId
string<uuid>
createdById
string<uuid> | null
updatedById
string<uuid> | null
createdAt
string<date-time>
updatedAt
string<date-time>
_count
object

Counts only links that are neither archived nor deleted.