← All skills

PDF

Your agent can't manipulate a PDF in its sandbox; this merges, splits, extracts, fills, stamps, and compresses them.

Documents

Reads, creates, and transforms PDF files: extract text and data, merge or split documents, fill interactive forms, stamp or watermark every page, and compress files for faster sharing. All operations work on files you provide by URL and return either a new PDF file or the extracted content inline.

Use when

You have one or more PDFs to combine, break apart, read, fill, watermark, or shrink.

Not for

Reading scanned or photographed PDFs (OCR), creating a PDF from scratch or from Office files, encrypting, rotating, or redacting.

What you can do

Each is a sub-skill of PDF; the router picks the right one for your request.

What you get back

file (application/pdf)

Returns a downloadable file (a single PDF, or a zip when a split yields several). Reading text or tables instead returns the content inline.

When it checks with you first

A combine spans several files whose order is not given, since the pages come out in exactly the order received.

Run it

Skills run through one gateway with your Faro token. Hand it an intent in plain language; Faro routes to the right sub-skill, runs it, and bills per call.

curl -X POST "https://skill.askfaro.com/skills/pdf/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"prompt":"Merge these two PDFs into one"}}'

Example requests

  • Merge these two PDFs into one
  • Extract pages 3 to 7 from this PDF
  • Extract all the text from this PDF
  • Pull the table from page 3 of this PDF