Developer Hub
Build document workflows with Renamed.to
Rename PDFs by content, split multi-page PDFs into individual documents, and automate via CLI. Simple REST APIs with Bearer token auth—integrate in minutes.
- Rename API:
POST /api/v1/rename(upload) andPOST /api/v1/rename-from-url(URL) - PDF Split API:
POST /api/v1/pdf-split+GET /api/v1/pdf-split/status/{jobId} - Tools: CLI for automation, API Playground for testing, SDKs for TypeScript, Python, Go, and more
Start with 50 free credits. View pricing
Quick facts
- REST API with JSON responses
- Bearer token authentication
- PDF files up to 25MB / 100MB
- OCR for scanned documents
- 20+ languages supported
Quickstart: Rename your first PDF
Get from zero to a working API call in under 2 minutes.
Get your API token
Create a free account and generate an API token from your dashboard. You'll get 50 free credits to start.
Install the SDK (recommended)
Use our TypeScript SDK for the best developer experience with full type safety.
npm install @renamed/sdkRename a PDF
Pass any PDF to the rename function. The AI reads the document content and generates a descriptive filename.
import { RenamedClient } from '@renamed/sdk'const client = new RenamedClient({ apiKey: process.env.RENAMED_API_KEY})// Rename a PDF based on its contentconst result = await client.rename('./invoice.pdf')console.log(result.suggestedFilename)// → "2024-01-15_AcmeCorp_INV-1234.pdf"→ Or use curl directly↓ Using curl
curl -X POST https://www.renamed.to/api/v1/rename \ -H "Authorization: Bearer rn_live_abc123..." \ -F file=@invoice.pdfDone! Here's your result
The API returns a suggested filename based on the document's content—date, vendor, document type, and reference numbers.
{ "originalFilename": "invoice.pdf", "suggestedFilename": "2024-01-15_AcmeCorp_INV-1234.pdf", "confidence": 0.94}Ready for more? Try it yourself in the API Playground.
Open API PlaygroundHow do you want to integrate?
Official SDKs
Type-safe clients for every language.
API Reference
Limits & security
API limits
- Rename: 25MB max file size
- Split: 100MB max file size
- Split jobs are async (poll for status)
- Rate limits based on your plan
Security & privacy
- TLS encryption for all transfers
- Files processed in memory, not stored
- SOC 2 Type II compliant
- GDPR data processing agreement available
Frequently asked questions
- How do I authenticate API requests?
- Generate an API token from Settings → API Tokens in your dashboard. Include it in requests as "Authorization: Bearer YOUR_TOKEN". Tokens can be rotated anytime.
- What are the API rate limits?
- Free accounts get 50 credits. Paid plans include higher limits based on your subscription. Each rename or split operation consumes credits based on file size and complexity.
- What file formats are supported?
- The Rename API supports PDF files up to 25MB. The PDF Split API supports PDF files up to 100MB. Both APIs include OCR for scanned documents.
- How does error handling work?
- All endpoints return standard HTTP status codes. 4xx errors include a JSON body with error details. Check the API docs for specific error codes and retry guidance.
- Is my data secure?
- Files are processed in memory and not stored permanently. We use TLS encryption for all transfers. See our Security page for SOC 2 compliance details and data retention policies.
Related resources
Discover solutions, integrations, and pricing for your use case