Docs
Schedule demo Open app

List files

GET https://app.eraser.io/api/files

Example request

curl --location 'https://app.eraser.io/api/files?limit=2&sort=-updatedAt' \
--header 'Authorization: Bearer $YOUR-TOKEN-HERE'

Example response

{
  "files": [
    {
      "id": "abc123",
      "fileUrl": "https://app.eraser.io/workspace/abc123",
      "title": "System Architecture",
      "author": "user-id-1",
      "folderId": null,
      "createdAt": "2025-07-01T12:00:00.000Z",
      "updatedAt": "2025-07-15T09:30:00.000Z",
      "linkAccess": "no-link-access"
    }
  ],
  "nextCursor": "abc123"
}

Query parameters

limit integer query

Maximum number of files to return (1-500). Defaults to 100.

cursor string query

Cursor for pagination. Use `nextCursor` from a previous response.

folderId string query

Filter files by folder ID

sort string query

Sort field with optional `-` prefix for descending order. Defaults to `-updatedAt`.

  • createdAt
  • -createdAt
  • updatedAt
  • -updatedAt
author string query

Filter by author (user ID or email address)

Responses

200 – A paginated list of files

files object[] required8 fields

Array of files in the current page
id string required

Unique identifier for the file

fileUrl string required

URL to view the file in Eraser

title string required

Title of the file

author string required

User ID of the file author

folderId string | null required

ID of the folder containing the file, or null if not in a folder

createdAt string required

ISO 8601 timestamp of when the file was created

updatedAt string required

ISO 8601 timestamp of when the file was last updated

linkAccess string required

Current link access setting for the file

  • no-link-access
  • anyone-with-link-can-edit
  • publicly-viewable
  • publicly-editable
  • sso-readable
  • sso-editable
nextCursor string | null required

Cursor for the next page of results, or null if there are no more results

200 response 
{
  "files": [
    {
      "id": "string",
      "fileUrl": "https://app.eraser.io/workspace/abc123",
      "title": "System Architecture",
      "author": "string",
      "createdAt": "2026-01-01T00:00:00Z",
      "updatedAt": "2026-01-01T00:00:00Z",
      "linkAccess": "no-link-access"
    }
  ]
}

400 – Invalid request parameters (e.g., invalid sort field, non-numeric limit, invalid cursor)

401 – Missing or invalid bearer token

403 – Unauthorized

500 – Internal server error