Skip to main content
Use these changes when updating a client built against the previous API documentation.

​
Request fields

The previous request names are temporarily accepted for compatibility with existing n8n clients. Use the current names for new code. Sending both spellings in one request is rejected. Authorization: Bearer is the recommended authentication header. X-API-Key remains supported.

​
Response fields

  • File objects now use parentPath instead of folderPath and include parentId. Folder objects also include parentPath.
  • Getting a file by ID returns content alongside its metadata.
  • A change awaiting review has status: "in_review" instead of "blocked".
  • Both searches return the list envelope with object: "list", url, hasMore, nextCursor, and data. Search does not paginate: hasMore is false and nextCursor is null.
  • Search sources identify their type with object instead of type.

​
Error codes

changes_in_review replaces pending_changes. A malformed change ID now returns invalid_id instead of invalid_change_id. Regenerate clients from the public OpenAPI specification to pick up the updated schemas and names.

​
Previous API reference

The previous reference included key validation, retrieval, and sync-log endpoints from a broader application specification. Those endpoints are outside the public API contract documented here. This documentation change does not establish that an endpoint has been disabled. The public API provides file and folder operations, hybrid search, and regex search. Hybrid search returns matching file content; it is not a drop-in replacement for an endpoint that generates an answer. Use the overview to select the operation you need, or contact support about an existing workflow.