Overview
This node integrates with CloudConvert to manage file conversion jobs. It supports operations to create new jobs, retrieve all jobs, get details of a specific job, and delete jobs. It is useful for automating file format conversions, managing conversion workflows, and handling job results programmatically. For example, users can create a job to convert files, list all jobs filtered by status or tag, or fetch details of a particular job for monitoring or further processing.
Use Case Examples
- Create a job to convert files with a specific job definition JSON.
- List all jobs filtered by status (e.g., finished) or by a custom tag.
- Get details of a specific job by its ID.
- Delete a job by its ID.
Properties
| Name | Meaning |
|---|---|
| Status Filter | Filter jobs by their status (All, Error, Finished, Processing). |
| Tag Filter | Filter jobs by a custom tag string. |
Output
JSON
id- Unique identifier of the job.status- Current status of the job.tag- Custom tag associated with the job.tasks- List of tasks included in the job, such as import, conversion, and export tasks.created_at- Timestamp when the job was created.updated_at- Timestamp when the job was last updated.
Dependencies
- CloudConvert API
Troubleshooting
- Ensure the CloudConvert API credentials are correctly configured and valid.
- If filtering by status or tag returns no results, verify the filter values are correct and that jobs matching those filters exist.
- For synchronous job creation with download enabled, large jobs may cause timeouts or performance issues; consider using asynchronous calls with webhooks instead.
Links
- CloudConvert Jobs API - Official API documentation for managing jobs on CloudConvert.
- CloudConvert Job Builder UI - Web UI to construct job definitions for CloudConvert.
