Public

Presign Upload

Mint short-lived, write-only upload URLs (step 1 of 2).

PUT each file's bytes to its upload_url, then call /v1/register_upload/ with the upload_ids to start extraction.

Nothing here is billable — the charge happens when the file is registered and actually processed.

post/v1/presign_upload/

Request

Base URL
https://api.koncile.ai (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer
TypeScript
https://skmtc.dev/koncile/apis/koncile-api/docs/v1/presign_upload/post.ts
A function with typed inputs. Its response is checked against the schema.

filenamesstring[] required

File names with extension, one upload URL is returned per name. This is the name the document will carry in Koncile.

folder_idinteger nullable

Folder to place the documents in. Optional.

template_idinteger nullable

Template to extract with. Optional — when omitted, the documents are classified against the company's templates.

metadatastring nullable

Optional JSON string stored alongside the upload.

{
  "filenames": [
    "invoice-01.pdf"
  ]
}

Successful Response