Skip to main content

List files

GET /projects/:projectid/library/files

The files in a library directory.

Lists files in a directory. Omit path for the library root.

Authentication​

  • Project API key: The credential for everything external. Created in Project Settings, bound to one project, and limited to the scopes it was granted. Format: proj.<keyId>.<secret>.
  • Execution token: Minted automatically for a running workflow and valid only for that workflow's project. Code nodes receive it as INTELLECTIBLE_EXECUTION_TOKEN — you never create one yourself. Format: exec_<jwt>.
  • Required permission: library.read.

Path parameters​

NameTypeRequiredDefaultDescription
projectidstringYes-The project id.

Query parameters​

NameTypeRequiredDefaultDescription
pathstringNo-Directory path, e.g. invoices/2026. Defaults to the root.

Example request​

curl -X GET \
  -H "Authorization: proj.KEY_ID.SECRET" \
  {{BASE_URL}}/projects/{{PROJECT_ID}}/library/files?path=invoices%2F2026

Responses​

200​

The files in that directory.

{
  "files": [
    {
      "id": "doc_7Yq1",
      "name": "invoice-104.pdf",
      "mimeType": "application/pdf",
      "size": 84213
    }
  ]
}

404​

No directory at that path.