Turn documents into public URLs for workflow APIs
The document already exists as an export or attachment. The next service fetches by URL. Upload it once and pass a direct document URL onward.
- Reviewed by
- GetFileURL technical team
- Updated
- File
- contract.docx
- Content type
- application/vnd.openxmlformats-officedocument.wordprocessingml.document and related document MIME types
- Not for
- a document editor, viewer, or conversion engine
What this page answers
The workflow fit is DOCX, XLSX, PPTX, CSV, TXT, and generated exports that another API needs to fetch.
- Reviewed by
- GetFileURL technical team
- Last updated
Office files often need direct access before they can be converted or parsed.
A document API usually fetches the URL server-side. It needs the original file bytes and headers, not a cloud editor preview page.
DOCX contracts
Pass generated contracts or templates to e-signature, CRM, or document conversion APIs.
XLSX exports
Host spreadsheet exports long enough for reporting, parsing, or import workflows.
PPTX and text files
Use direct URLs for generated presentations, transcripts, markdown, CSV, and support documents.
Preserve document type so the destination can process the file.
Many document APIs branch by content type and extension. A generic binary response or HTML page can break parsing.
Content type
Keep the document MIME type visible in both response metadata and delivery headers.
Filename
Use meaningful names so destination logs, imports, and customer workflows are diagnosable.
Expiry
Keep the URL available through async conversion, import, or review queues.
Use the PDF page when the source is already a PDF.
Documents and PDFs have overlapping workflows, but the failure modes differ. Documents often involve editing formats, conversion, and office MIME types.
Use document-to-URL
For DOCX, XLSX, PPTX, TXT, CSV, and generated office exports.
Use PDF-to-URL
For invoices, contracts, reports, and document processors that require `application/pdf`.
Use delete controls
Remove document access after the conversion, import, or review job completes.
Copy the same upload shape into code
curl -X POST https://api.getfileurl.com/v1/files \
-H 'Authorization: Bearer $GETFILEURL_KEY' \
-F 'file=@contract.docx' \
-F 'visibility=public'Common questions
What document types can become URLs?
The workflow fit is DOCX, XLSX, PPTX, CSV, TXT, and generated exports that another API needs to fetch.
Is this a document conversion API?
No. GetFileURL focuses on hosting the document long enough for another service to fetch, parse, convert, or import it.
Why not pass a Google Docs or Drive link?
Those links can open preview pages or permission prompts. A document API usually needs direct file bytes at the URL.