API Image Management in Doxy: How to Manage Images Programmatically

Doxy Introduces API Image Management: Streamline Your Document Generation Workflow
Doxy, the platform that transforms Google Docs templates into powerful PDF generators, has just released a game-changing feature: programmatic image management via API. This highly-requested functionality empowers users to fully automate their document generation workflows, especially when dealing with personalized images at scale.
The Challenge
Managing images through a UI can be cumbersome and time-consuming, particularly when you need to inject unique images into documents programmatically. Whether you're handling electronic signatures, company logos, product images, or ID photos, manual image management can become a bottleneck in your automation workflow.
How Does API Image Management Work?
Doxy's implementation of image management is powerful yet straightforward, offering multiple API endpoints for different use cases:
/v1/images/url
- Upload images via URLs (supports bulk uploads)/v1/images/base64
- Upload single images using Base64 encoded data/v1/images/multipart
- Upload single binary images
The process is simple:
- Upload Images: Use any of the API endpoints to upload your images, specifying a unique slug and expiration period.
- Reference Images: Include image slugs in your API JSON payload when generating documents. Use
{{image_slug}}
as a placeholder in your Google Docs template, or{{img:image_slug}}
for inline images. - Generate Documents: Doxy automatically replaces the placeholders with corresponding images during document generation, maintaining aspect ratios and positioning.
Key Features
- Custom Slugs: Assign unique identifiers to each image for easy reference in your documents
- Secure Storage: All images are stored in encrypted cloud storage with access granted via temporary, signed URLs
- Flexible Expiration: Set custom expiration periods (1 day, 1 week, or never) for enhanced storage management
- Multiple Upload Methods: Choose from URL-based, Base64, or binary upload options to suit your needs
Benefits of API Image Management
- Full Automation: Create end-to-end automated workflows without manual image handling
- Scalability: Easily manage thousands of unique images programmatically
- Security: Benefit from encrypted storage and temporary access URLs
- Flexibility: Choose from multiple upload methods and expiration policies
Use Cases
API Image Management enables numerous powerful workflows:
- Digital Signatures: Automatically include signature images in contracts
- Brand Management: Dynamically insert company logos in documents
- Product Documentation: Include product images in automated spec sheets
- ID Verification: Handle identity documents in automated workflows
Best Practices
- Unique Slugs: Use descriptive, unique identifiers for your images
- Image Optimization: Upload appropriately sized images to maintain performance
- Expiration Management: Set appropriate expiration periods based on your needs
- Error Handling: Implement proper error handling for upload and reference processes
Conclusion
Doxy's new API Image Management feature represents a significant step forward in document automation, enabling truly end-to-end programmatic workflows. By eliminating manual image handling, businesses can create more efficient, scalable document generation processes that save time and reduce errors.
Ready to get started? Check out our API documentation to begin implementing programmatic image management in your workflows.