Tools API

Call any of these tools with one request. Pay only for what you use.

Read documents

Extract data

POST /api/v1/tools/extract

Reads a document into the fields you ask for, with the page each value came from.

Read a document

POST /api/v1/tools/read

The text of a PDF, Word file, spreadsheet or CSV. Scanned pages are read with OCR.

Decide

POST /api/v1/tools/decide

Chooses from your options, scores against levels, or answers yes or no, with how sure it is.

Compare

POST /api/v1/tools/compare

Checks two to five documents against each other, field by field and line by line.

PDF

Merge PDFs

POST /api/v1/tools/merge_pdfs

Joins two to twenty PDFs into one, in order.

Split a PDF

POST /api/v1/tools/split

Splits one PDF into separate documents, by page ranges, a number pattern or a description.

Compress a PDF

POST /api/v1/tools/compress_pdf

Makes a PDF smaller by shrinking its pictures.

Flatten a PDF

POST /api/v1/tools/flatten_pdf

Turns a PDF form's fields into fixed text that can no longer be changed.

PDF to images

POST /api/v1/tools/pdf_to_images

Turns a PDF's pages into PNG or JPG pictures, one per page.

Images to PDF

POST /api/v1/tools/images_to_pdf

Puts PNG or JPG pictures into one PDF, one per page.

Images

Generate an image

POST /api/v1/tools/generate_image

A new picture made by AI from a description.

Edit an image

POST /api/v1/tools/edit_image

Changes a picture as described, keeping the rest of it.

Example

POST /api/v1/tools/extract
curl -X POST https://automette.com/api/v1/tools/extract \
  -H "Authorization: Bearer dg_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "file": { "name": "invoice.pdf", "url": "https://…/invoice.pdf" },
      "instructions": "Invoice number, date, total and every line item"
    }
  }'
200 OK · status: completed · result, credits_used