Cloudlayer

16 tools available

cloudlayer.io is a document and asset generation service that enables users to dynamically create PDFs and images through a REST-based API, SDKs, or no-code integrations.

Connect Cloudlayer to Definable to auto-index uploads, answer questions over a doc set, extract structured fields from contracts. Personas call Cloudlayer's 16 tools directly from chat or scheduled flows. Connect this integration to a knowledge persona — the agent will ground answers in your documents with citations.

Common workflows with Cloudlayer

01

Auto-index new files

  1. Watch for new uploads
  2. Chunk, embed, and index
  3. Make queryable via your knowledge persona
02

Q&A against a folder

  1. Pin a folder as a brain
  2. Ask the persona questions
  3. Returns answers with citations
03

Document-trigger flows

  1. New contract uploaded
  2. Persona extracts key terms
  3. Routes to the right approver

Cloudlayer actions 16

Every Cloudlayer action below is a callable tool any Definable persona can invoke.

Add Storage

Add a user-owned S3-compatible storage configuration for storing generated assets. This action allows Enterprise plan users to configure their own S3-compatible storage (AWS S3, DigitalOcean Spaces, Wasabi, MinIO, etc.) instead of using the built-in cloud storage included with Cloudlayer accounts. Note: User storage is only available on Enterprise plans. Standard plans will receive an 'allowed: false' response indicating the feature requires a plan upgrade.

Convert HTML to Image (V2)

Convert HTML content to an image (PNG, JPG, or WebP) using the v2 API endpoint. Renders the provided HTML string using a headless browser and returns job details with the generated image asset. Supports various rendering options including viewport configuration, transparency, auto-scroll, and custom wait conditions.

Convert HTML to PDF (v2)

Tool to convert HTML content to PDF using CloudLayer v2 API. Use when you need to generate a PDF from raw HTML with advanced options like custom paper size, margins, headers/footers, and viewport settings. The HTML is automatically Base64 encoded before sending to the API.

Convert URL to PDF (Simple)

Tool to convert a URL to PDF using GET request. Use when you need quick PDF conversion with minimal parameters and immediate result.

Delete Storage Configuration

Tool to delete a specific user storage configuration. Use when you need to remove an external bucket configuration by its ID after confirming the ID is correct.

Get Account Info

Tool to retrieve Cloudlayer account usage, credits, and document counts. Use when monitoring account limits and subscription status.

Get Asset

Tool to retrieve a specific asset by its ID. Use when you need to fetch metadata or download URL of an existing asset after its generation.

Get Job By ID

Retrieve details of a specific Cloudlayer job by its ID. Use this to check the status of an async job, get the asset download URL after completion, or view job parameters. Returns 401 if the job ID doesn't exist or doesn't belong to your account.

Get API Status

Tool to test API reachability. Use when checking if the Cloudlayer API is available.

Get Storage Configuration by ID

Tool to retrieve a specific storage configuration by its ID. Use when you need to inspect or validate details of a user storage configuration.

List Assets

List assets in your CloudLayer account with cursor-based pagination. Returns PDFs and images generated via HTML/URL conversion jobs. Use this to find asset IDs for further operations like downloading or deleting assets.

List Jobs

List jobs in your CloudLayer account with cursor-based pagination. Use when you need to view your recent jobs and their statuses.

List Storage Configurations

Retrieves all user storage configurations (S3-compatible buckets) for the authenticated Cloudlayer account. Use this to view configured external storage destinations where generated documents can be saved. Note: User Storage is an Enterprise plan feature. Non-Enterprise accounts will receive an empty list.

Template to PDF

Generate a PDF document from an HTML/Nunjucks template with dynamic data. Provide either: - A `templateId` for predefined templates from CloudLayer's template library, OR - A base64-encoded `template` string containing custom HTML/Nunjucks markup. The `data` parameter populates template variables (e.g., {{name}}, {{items}}) with your JSON data. By default, jobs run asynchronously and return a job ID to poll for completion via get_job_by_id.

Convert URL to Image

Converts a webpage URL to an image (PNG, JPG, or WebP). Supports custom viewport settings, wait conditions, transparency, auto-scroll, and thumbnail preview generation. The API is asynchronous - use the returned job ID to poll for results.

Convert URL to PDF

Tool to convert a URL to PDF with full parameter support. Use when you need advanced control over paper size, margins, headers/footers, or webhook callbacks.

Frequently asked questions

What can I automate with Cloudlayer on Definable?

Anything Cloudlayer exposes through its API. Common documents workflows on Definable include auto-index uploads, answer questions over a doc set, extract structured fields from contracts. Personas can call any of the 16 Cloudlayer tools directly, then chain the result into another integration without you writing code.

How does Cloudlayer authentication work?

Cloudlayer uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Cloudlayer integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 16 Cloudlayer tools. You only need a separate Cloudlayer subscription if Cloudlayer itself charges per seat or per API call.

Is using Cloudlayer through Definable secure?

Every call from a persona to Cloudlayer is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Cloudlayer on Definable?

Sign up for Definable, open the integrations page, find Cloudlayer, and connect via OAuth or API key. You can immediately attach Cloudlayer to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Cloudlayer actions does Definable expose?

Definable exposes all 16 Cloudlayer actions as callable tools — including `Add Storage`, `Convert HTML to Image (V2)`, `Convert HTML to PDF (v2)`, plus 13 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Cloudlayer?

Wire it up in minutes. No coding required.

← All integrations