Upload files

curl "https://api.conare.ai/namespaces/docs/files?name=handbook.pdf" \
  -H "Authorization: Bearer $CONARE_API_KEY" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @handbook.pdf

import { readFile } from "node:fs/promises";

const file = await readFile("handbook.pdf");
await docs.uploadFile(file, "handbook.pdf");

{
  "file_id": "handbook.pdf",
  "type": "pdf",
  "pages": 2,
  "ids": ["handbook.pdf:page-1", "handbook.pdf:page-2"],
  "pages_without_text": []
}

​

Request

• name (string, required): The file’s name.
• id (string): The file id, which prefixes its document ids. 1-180 characters of A-Z a-z 0-9 . _ -, starting with a letter or digit. Defaults to name, with other characters replaced by -.

​

Response

• file_id: The file id.
• type: pdf or xlsx.
• ids: The documents written, in reading order.
• pages (PDF) or sheets (workbook): How many the file has.
• pages_without_text (PDF): Pages that weren’t stored because they have no text layer, such as scans.

​

Documents

​

Working with files

• Update a file by uploading it again with the same file id. Its old documents are replaced.
• Search one file with a filter: { "file_id": "handbook.pdf" }.
• Delete a file with a filter delete: { "filter": { "file_id": "handbook.pdf" } }.

​

Errors

• 415 unsupported_file: The body is neither a PDF nor an .xlsx.
• 422 unreadable_file: The file is damaged or encrypted.
• 422 no_text: No page or sheet has text.