Skip to main content
GET
/
api
/
v1
/
workspaces
/
{id}
/
folders
List folders
curl --request GET \
  --url https://api.getarca.app/api/v1/workspaces/{id}/folders \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 10,
    "workspace_id": 3,
    "name": "Engineering",
    "icon": "folder-1",
    "color": "blue",
    "position": 1,
    "created_at": "2026-01-10T12:00:00.000Z"
  },
  {
    "id": 11,
    "workspace_id": 3,
    "name": "Design",
    "icon": "folder-2",
    "color": "purple",
    "position": 2,
    "created_at": "2026-01-12T09:30:00.000Z"
  }
]
Requires the folders:read scope. You must be a member of the workspace. Access-restricted members only receive folders they have been explicitly granted access to.

​
Path parameters

​
id
string
required
The numeric workspace ID.

​
Response

Returns an array of folder objects.
​
id
number
required
Folder identifier.
​
workspace_id
number
required
ID of the workspace this folder belongs to.
​
name
string
required
Folder name.
​
icon
string | null
Icon identifier slug (e.g., "folder-1", "folder-2", "library"). null if not set.
​
color
string | null
Folder color.
​
position
number
required
Numeric sort position. Folders are ordered by this value ascending.
​
created_at
string
required
UTC ISO-8601 creation timestamp.
[
  {
    "id": 10,
    "workspace_id": 3,
    "name": "Engineering",
    "icon": "folder-1",
    "color": "blue",
    "position": 1,
    "created_at": "2026-01-10T12:00:00.000Z"
  },
  {
    "id": 11,
    "workspace_id": 3,
    "name": "Design",
    "icon": "folder-2",
    "color": "purple",
    "position": 2,
    "created_at": "2026-01-12T09:30:00.000Z"
  }
]