Create app folder

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Creates a folder for builder apps or agents.

You can change your own personal folders. Workspace folders need the editor role or higher, and any editor can change any workspace folder. A workspace holds up to 500 folders of both kinds, counting every member's personal folders, and a folder can have at most 20 folders above it. Folder names don't have to be unique, so retrying a create that timed out can leave you with two folders.

This is limited to 60 requests per minute, shared with the other endpoints that change folders. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.

<Note>Call this with a personal access token sent as a Bearer token, or from a signed-in session. A token works on its own workspace's folders. Workspace API keys aren't accepted, and a read-only token is refused.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

{
  "name": "Client projects",
  "scope": "workspace",
  "parent_folder_id": "68c1f27eb4e7d3005a2c9e0f",
  "position": 2,
  "color": "#3B82F6",
  "icon": "briefcase",
  "app_type": "user_app"
}

{
  "id": "68c1f2a9b4e7d3005a2c9e11",
  "name": "Client projects",
  "parent_folder_id": "68c1f27eb4e7d3005a2c9e0f",
  "scope": "workspace",
  "position": 2,
  "color": "#3B82F6",
  "icon": "briefcase",
  "app_type": "user_app",
  "created_date": "2026-08-01T09:15:00"
}