PDF Blocks API
✓ Official Vendor SpecDeveloper ToolsTesting QaapiKey12 EndpointsREST
For Agents
Merge PDFs, manage passwords and restrictions, add watermarks, and manipulate pages (extract, remove, rotate, reverse) for secure document workflows.
Use for: I need to merge several PDF files into one document, I want to add a password to protect a PDF, Extract pages 3 through 7 from a PDF document, Remove the password from a locked PDF file
Not supported: Does not handle format conversion, OCR, or AI data extraction — use for page manipulation, security management, and watermarking only.
PDF Blocks API provides secure PDF manipulation operations including document merging, page extraction, removal, rotation, and reversal, password and restriction management, watermarking with text or images, and digital signature removal. All operations accept PDF files via multipart upload and return processed files directly in the response. The API focuses on document security and page-level manipulation without format conversion.
Install Jentic One Beta
Connect the PDF Blocks API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the PDF Blocks API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with PDF Blocks API.
Merge multiple PDF documents into a single consolidated file
Extract specific pages from a PDF into a new document
Add and remove password protection on PDF files
Apply text or image watermarks to all pages of a document
Set and remove usage restrictions (print, copy, edit) on PDFs
Rotate individual pages or all pages in a document
Remove digital signatures from signed PDF documents
Use Cases
Patterns agents use PDF Blocks API for, with concrete tasks.
★ Document Security Management
Add, modify, or remove security features on PDF documents. PDF Blocks handles password protection via POST /v1/add_password, usage restrictions (disable printing, copying, editing) via POST /v1/add_restrictions, and signature removal via POST /v1/remove_signatures. This enables compliance workflows where documents need different security levels at different stages of their lifecycle.
Add a user password 'readonly123' and owner password 'admin456' to a PDF document via POST /v1/add_password with the file uploaded as multipart form data
PDF Page Manipulation
Modify page structure within PDF documents by extracting, removing, rotating, or reversing pages. POST /v1/extract_pages creates a new PDF containing only specified pages. POST /v1/remove_pages removes unwanted pages. POST /v1/rotate_pages changes page orientation. These operations enable automated document assembly and cleanup workflows.
Extract pages 1, 3, and 5 from a 10-page PDF via POST /v1/extract_pages and download the resulting 3-page document
Document Watermarking
Apply text or image watermarks across all pages of a PDF document for branding, confidentiality marking, or draft identification. POST /v1/add_watermark/text adds configurable text overlays (font, size, color, rotation, opacity) and POST /v1/add_watermark/image adds logo or stamp overlays. Watermarks are rendered as transparent layers on each page.
Add a diagonal text watermark 'DRAFT' in red at 50% opacity to all pages of a PDF via POST /v1/add_watermark/text
AI Agent Document Operations via Jentic
AI agents use the PDF Blocks API through Jentic to merge documents, manage security, and manipulate pages without handling API keys directly. Agents search by intent, receive typed schemas for PDF operations, and execute calls with Jentic managing the X-Api-Key header injection. This enables automated document preparation workflows in legal, compliance, and publishing contexts.
Search Jentic for 'merge PDF documents', load the schema for POST /v1/merge_documents, and execute with two PDF files to produce a combined document
Key Endpoints
12 endpoints — pdf blocks api provides secure pdf manipulation operations including document merging, page extraction, removal, rotation, and reversal, password and restriction management, watermarking with text or images, and digital signature removal.
METHOD
PATH
DESCRIPTION
POST
/v1/merge_documents
Merge multiple PDF files into one
POST
/v1/extract_pages
Extract specific pages into a new PDF
POST
/v1/remove_pages
Remove pages from a PDF
POST
/v1/add_password
Add password protection to a PDF
POST
/v1/remove_password
Remove password from a PDF
POST
/v1/add_watermark/text
Add text watermark to all pages
POST
/v1/add_watermark/image
Add image watermark to all pages
POST
/v1/rotate_pages
Rotate pages in a PDF
POST
/v1/merge_documents
Merge multiple PDF files into one
POST
/v1/extract_pages
Extract specific pages into a new PDF
POST
/v1/remove_pages
Remove pages from a PDF
POST
/v1/add_password
Add password protection to a PDF
POST
/v1/remove_password
Remove password from a PDF
POST
/v1/add_watermark/text
Add text watermark to all pages
POST
/v1/add_watermark/image
Add image watermark to all pages
POST
/v1/rotate_pages
Rotate pages in a PDF
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
PDF Blocks X-Api-Key is stored encrypted in the Jentic vault. Agents receive authenticated API access without the raw key appearing in agent context or logs.
Intent-based discovery
Agents search by intent (e.g., 'add password to PDF') and Jentic returns matching PDF Blocks operations with typed schemas specifying file upload and parameter requirements.
Time to first call
Direct PDF Blocks integration: 1 day for auth setup and multipart upload handling. Through Jentic: under 30 minutes — search, load schema, execute with automatic file handling.
Related APIs
Alternatives and complements available in the Jentic catalogue.
Alternative
iLovePDF API
PDF toolkit with compression and office format conversion alongside merge and split
Choose iLovePDF when you need PDF compression or conversion to/from Office formats alongside page manipulation.
FAQs
Specific to using PDF Blocks API through Jentic.
What authentication does the PDF Blocks API use?
The PDF Blocks API uses an API key passed in the X-Api-Key header. You obtain your key from the PDF Blocks dashboard at dashboard.pdfblocks.com. A free tier is available for testing. Through Jentic, this key is stored encrypted and injected automatically.
Can I merge more than two PDF files at once?
Yes. POST /v1/merge_documents accepts multiple PDF files via multipart form data upload. The files are merged in the order they are submitted, producing a single output PDF containing all pages from all input documents.
What are the rate limits for the PDF Blocks API?
The free tier allows 50 operations per month with files up to 5MB. Paid plans increase limits to 1000+ operations per month and support files up to 50MB. Rate limiting is applied per API key with a per-second burst limit of 5 requests.
How do I add a watermark through Jentic?
Search Jentic for 'watermark PDF document', load the schema for POST /v1/add_watermark/text, and execute with the PDF file and watermark parameters (text, font size, color, rotation, opacity). Jentic handles the X-Api-Key injection and returns the watermarked PDF.
Can I remove password protection from a PDF?
Yes. POST /v1/remove_password accepts a password-protected PDF and the current password, then returns an unprotected version. You must know the existing password to remove protection. This is useful for automated workflows processing received documents that need to be unlocked for further manipulation.
GET STARTED