> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qontext.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrating existing clients

> Move from the previous API contract to the current public API and identify legacy endpoints.

Use these changes when updating a client built against the previous API documentation.

## Request fields

| Operation                 | Previous field | Current field |
| ------------------------- | -------------- | ------------- |
| List files                | `folder_id`    | `parent_id`   |
| Create a file in a folder | `fileName`     | `name`        |
| Move a file               | `folderId`     | `parentId`    |

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](/api-reference/public-api.json) 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](/api-docs/overview) to select the operation you need, or contact [support](mailto:support@qontext.ai) about an existing workflow.