Docs
Schedule demo Open app

Get a folder

GET https://app.eraser.io/api/folders/{folderId}

Example request

curl --location 'https://app.eraser.io/api/folders/xK9mPq2vR' \
--header 'Authorization: Bearer $YOUR-TOKEN-HERE'

Example response

{
  "id": "xK9mPq2vR",
  "name": "Design Docs",
  "order": 0,
  "teamId": "tN4wLm8jY",
  "createdBy": "uB7cHd3sW",
  "createdAt": "2025-07-01T12:00:00.000Z",
  "updatedAt": "2025-07-15T09:30:00.000Z",
  "parentFolderId": null
}

Path parameters

folderId string requiredpath

Responses

200 – The folder

id string required

Unique identifier

name string required

Folder name

order integer required

Sort order among siblings

teamId string required

Team ID

createdBy string required

Creator's user ID

createdAt string required

Creation timestamp

updatedAt string required

Last updated timestamp

parentFolderId string | null required

Parent folder ID, or null if root-level

200 response
{
  "id": "string",
  "name": "string",
  "order": 0,
  "teamId": "string",
  "createdBy": "string",
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

400 – Invalid folder ID

401 – Missing or invalid bearer token

403 – Unauthorized

404 – Folder not found

500 – Internal server error