// Edit and fill PDF documents. Use when the user wants to fill a PDF form, add text/signatures/checkboxes/images to a PDF, or annotate a PDF. Accepts a PDF URL or file upload and returns a ready-to-use editor link. URL inputs are passed through directly. File uploads are stored temporarily (24 hours) then deleted.
| name | edit-pdf |
| description | Edit and fill PDF documents. Use when the user wants to fill a PDF form, add text/signatures/checkboxes/images to a PDF, or annotate a PDF. Accepts a PDF URL or file upload and returns a ready-to-use editor link. URL inputs are passed through directly. File uploads are stored temporarily (24 hours) then deleted. |
Edit and fill PDF documents directly in the browser. Add text, signatures, checkboxes, images, and more.
For public PDF URLs, use GET with the URL as a query parameter:
GET https://agents.simplepdf.com?url=https://example.com/form.pdf
For signed or sensitive URLs (e.g. presigned S3 links), use POST with a JSON body to keep the URL out of logs and browser history:
curl -X POST https://agents.simplepdf.com \
-H "Content-Type: application/json" \
-d '{"url": "https://s3.amazonaws.com/bucket/doc.pdf?X-Amz-Signature=..."}'
Both return JSON with the editor URL and embed snippets.
Upload a PDF file to the API. For security and privacy, the file is stored temporarily (24 hours) then automatically deleted. The user has 24 hours to open the link. Once opened, the PDF is loaded into the browser and processed entirely client-side, so the tab can stay open indefinitely.
curl -X POST https://agents.simplepdf.com -F file=@document.pdf
const form = new FormData();
form.append("file", new Blob([pdfBytes], { type: "application/pdf" }), "document.pdf");
const response = await fetch("https://agents.simplepdf.com", { method: "POST", body: form });
const { url } = await response.json();
import requests
with open("document.pdf", "rb") as f:
response = requests.post("https://agents.simplepdf.com", files={"file": f})
url = response.json()["url"]
Always present the url field as a clickable link. This is the primary way users will open the editor.
If you have access to a browser automation tool (e.g. agent-browser, Playwright, chrome-devtools MCP server), offer to open the url directly so the user can edit the PDF without leaving the conversation.
The iframe and react fields are for developers embedding the editor in a web application. Only present these when the user is building a web app.
Add companyIdentifier to route to a custom SimplePDF portal:
GET https://agents.simplepdf.com?url=https://example.com/form.pdf&companyIdentifier=acme
Or in a POST JSON body:
{"url": "https://example.com/form.pdf", "companyIdentifier": "acme"}
When using a companyIdentifier, the account owner has access to:
These features are configured in the SimplePDF admin console. No additional API parameters are needed - they apply automatically when the companyIdentifier is set.
{
"url": "https://...",
"iframe": "<iframe src=\"...\" width=\"100%\" height=\"800\" frameborder=\"0\"></iframe>",
"react": "<EmbedPDF mode=\"inline\" documentURL=\"...\" />"
}
| Field | Description |
|---|---|
url | Direct link to open the PDF in the SimplePDF editor |
iframe | HTML snippet to embed the editor in a web page |
react | React component snippet (see example below) |
Requires @simplepdf/react-embed-pdf (npm install @simplepdf/react-embed-pdf):
import { EmbedPDF } from "@simplepdf/react-embed-pdf";
const PDFEditor = ({ documentURL }: { documentURL: string }) => (
<EmbedPDF mode="inline" companyIdentifier="ai" documentURL={documentURL} />
);
With a company-specific portal, replace "ai" with the portal identifier:
<EmbedPDF
mode="inline"
companyIdentifier="acme"
documentURL="https://example.com/form.pdf"
/>
Once the user opens the editor link, they can:
SimplePDF is not responsible for the content of uploaded PDFs. By using this service, you agree that you have the right to process the documents you upload. For concerns or requests, contact support@simplepdf.com.