NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
CloudConvert connects to a Nagent workspace with an API key. Once it is connected, agents can call 9 CloudConvert actions, such as "Create Export Google Cloud Storage Task", "Create Export S3 Task" and "Create Webhook". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against CloudConvert, with input parameters and output schema.
CLOUDCONVERT_CREATE_EXPORT_GOOGLE_CLOUD_STORAGE_TASKTool to create a task to export files to a Google Cloud Storage bucket. Use after conversion when you need to store results directly into GCS. Ensure service account credentials have the proper permissions.
Input parameters
Filename/path for the exported file in the bucket.
The ID of the task to export. Multiple task IDs can be provided as a list.
The Google Cloud Storage bucket name.
The Google Cloud Project ID (`api-project-...`).
Prefix for exported files in the bucket when exporting multiple files.
The private key of the service account (PEM-encoded).
Service account client email (e.g., `my-sa@api-project-123456.iam.gserviceaccount.com`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CLOUDCONVERT_CREATE_EXPORT_S3_TASKTool to create a task to export files to an Amazon S3 bucket. Use after conversion when you need to store results directly into S3. Ensure AWS credentials have s3:PutObject (and PutObjectAcl if using non-default ACL) permissions.
Input parameters
S3 ACL for stored objects. Defaults to 'private'.
S3 object key (filename and path) for storing the file. Supports printf-style placeholders for multiple files, e.g., 'file-%d.pdf'.
The ID of the task to export, or a list of task IDs.
The Amazon S3 bucket where to store the file(s).
S3 region identifier (e.g., 'us-west-2' or 'eu-west-1').
S3 object tags as key–value pairs.
Custom S3 API endpoint URL. Overrides default built from region. Use for S3-compatible services.
Additional S3 metadata as key–value pairs (e.g., 'x-amz-meta-*').
Prefix to prepend to the S3 object key when exporting multiple files.
Value for the 'Content-Type' header. Auto-detected if omitted.
AWS access key ID with `s3:PutObject` permission.
Value for the 'Cache-Control' header (e.g., 'max-age=172800').
AWS session token for temporary (STS) credentials.
AWS secret access key.
Value for the 'Content-Disposition' header (e.g., 'attachment' or 'inline').
Server-side encryption algorithm to use (AES256 or aws:kms).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CLOUDCONVERT_CREATE_WEBHOOKCreates a new webhook to receive CloudConvert event notifications. Use this when you need to be notified about job status changes (created, finished, or failed) via HTTP POST requests to your server.
Input parameters
The target URL where CloudConvert will send webhook notifications. Must be a publicly accessible HTTPS URL.
Event type to subscribe to. Valid values: 'job.created' (when a job is created), 'job.finished' (when a job completes successfully), 'job.failed' (when a job fails).
Optional custom payload object to include in each webhook notification. Useful for passing context like user IDs or request identifiers.
Optional secret used to sign webhook payloads via HMAC-SHA256. Use this to verify that webhook requests originate from CloudConvert.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CLOUDCONVERT_DELETE_WEBHOOKPermanently delete a webhook by its ID. Use this when you no longer need to receive event notifications for a specific webhook. The webhook ID can be obtained from the create_webhook or list_webhooks actions.
Input parameters
The numeric ID of the webhook to delete. Obtain this from the create_webhook or list_webhooks actions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CLOUDCONVERT_LIST_OPERATIONSTool to list all possible CloudConvert operations with their available options and engine details. Use when you need to discover what operations are available, check operation requirements, or filter by input/output formats before creating tasks.
Input parameters
Comma-separated list of additional data to include. Options: 'options' (operation parameters), 'engine_versions' (available engine versions).
Filter operations by input format. Only returns operations that accept this format as input.
Filter operations by output format. Only returns operations that produce this format as output.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CLOUDCONVERT_LIST_SUPPORTED_FORMATSTool to list all supported conversion formats, engines, and options. Use when you need to discover available conversions before creating tasks.
Input parameters
Include additional data: options and/or engine_versions.
Set to true to include alternative conversion types.
Filter to include only conversions with this engine name.
Filter to include only conversions with this input format.
Filter to include only conversions with this output format.
Filter to include only conversions with this engine version.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CLOUDCONVERT_LIST_TASKSList all CloudConvert tasks with their status, payload and results. Use this tool to: - Monitor conversion task progress and status - Find tasks by status (waiting, processing, finished, error) - Filter tasks by job ID to see all tasks in a specific job - Retrieve task results and output file URLs - Debug failed conversions by checking error codes and messages Tasks are automatically deleted 24 hours after completion.
Input parameters
Page number to retrieve (1-indexed). Use with per_page for pagination through large result sets.
Filter tasks by job ID. Only returns tasks belonging to the specified job.
Filter tasks by status: 'waiting' (queued), 'processing' (in progress), 'finished' (completed successfully), or 'error' (failed).
Comma-separated list of additional data to include in response. Options: 'retries' (retry tasks), 'depends_on_tasks' (task dependencies), 'payload' (submitted configuration).
Order results by a column with optional direction. Format: 'column_name \[asc\\ | desc\]'. Common columns: 'created_at', 'ended_at'.
Number of tasks per page. Default is 100, maximum is 500.
Filter tasks by operation type, e.g., 'convert', 'import/url', 'import/s3', 'export/url', 'export/s3'.
Filter tasks by creation datetime in ISO 8601 format. Supports comparison operators like \[gte\] for date ranges.
Filter tasks by completion datetime in ISO 8601 format. Only applies to finished or error status tasks.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CLOUDCONVERT_LIST_WEBHOOKSTool to list all webhooks. Use when you need to retrieve existing webhooks before managing or inspecting them.
Input parameters
Page number to return (default: 1)
Number of webhooks per page (default: 100)
Filter results to webhooks with this URL
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CLOUDCONVERT_SHOW_USERRetrieves the current authenticated user's CloudConvert account information. Returns the user's ID, username, email, remaining conversion credits, and account creation date. Requires the 'user.read' scope. Useful for verifying authentication and checking available credits.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 9 CloudConvert actions on Nagent, including "Create Export Google Cloud Storage Task", "Create Export S3 Task" and "Create Webhook". Create Export Google Cloud Storage Task: Create a task to export files to a Google Cloud Storage bucket. Each action is listed on this page with its input parameters and its output.
CloudConvert connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create Export Google Cloud Storage Task takes 5 required inputs: input, bucket, project_id, private_key and client_email. It also takes 2 optional inputs: file and file_prefix. It returns data, error and successful.