> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to cloudlayer.io

The cloudlayer.io connector lets your AI agent act in each user's cloudlayer.io account. Each user connects their own cloudlayer.io API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 14 tools.

**Authentication:** API Key
**Categories:** Files & Documents
**Tools:** 14: 7 read, 6 write, 1 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=CLOUDLAYER)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the cloudlayer.io connection

   In **AgentKit > Connections**, create a cloudlayer.io connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'cloudlayer'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize cloudlayer.io:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'cloudlayer_account_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "cloudlayer"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize cloudlayer.io:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="cloudlayer_account_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their cloudlayer.io credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'cloudlayer_account_get',
  toolInput: {},
  connector: 'cloudlayer',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="cloudlayer_account_get",
    tool_input={},
    connection_name="cloudlayer",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `cloudlayer_account_get`

Get Account · Read-only

Get your cloudlayer.io account usage and limits.
Returns the subscription, calls used and limit, remaining credit, bytes, compute time, storage and job counts.
Use it to check quota before large batches.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `cloudlayer_asset_get`

Get Asset · Read-only

Get one stored generated file.
Returns its job id, extension, MIME type, size and pre-authenticated download URL.
Use assets_list to find asset IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `asset_id` (`string`, required): ID of the asset, from assets_list. Example: aBcDeFgHiJk123.

Example input: `{"asset_id":"<asset_id>"}`

### `cloudlayer_assets_list`

List Assets · Read-only

List your stored generated files, newest first, with cursor paging.
Returns each asset's id, job id, extension, MIME type, size, download URL and timestamp.
Match jobId to find the file a job produced.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Number of assets to return, 1 to 100. Defaults to 10. Example: 20.
- `start_after_id` (`string`, optional): Asset ID to continue after, for the next page. Example: aBcDeFgHiJk123.

Example input: `{}`

### `cloudlayer_job_get`

Get Job · Read-only

Get one generation job.
Returns its type, status (pending, success or error), parameters, size, processing time and credit cost.
Poll it after a generation tool until status is success.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `job_id` (`string`, required): ID of the job, from a generation tool's response or jobs_list. Example: 1705312200000.

Example input: `{"job_id":"<job_id>"}`

### `cloudlayer_jobs_list`

List Jobs · Read-only

List your most recent generation jobs, newest first, with cursor paging.
Returns each job's id, type, status, parameters, size, processing time, credit cost and timestamp.
Use job_get to check one job.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Number of jobs to return, 1 to 100. Defaults to 10. Example: 20.
- `start_after_id` (`string`, optional): Job ID to continue after, for the next page. Example: 1705312200000.

Example input: `{}`

### `cloudlayer_storage_get`

Get Storage Configuration · Read-only

Get one S3-compatible storage configuration.
Returns its title, bucket, region and endpoint (not the secret key).
Use storage_list to find configuration IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storage_id` (`string`, required): ID of the storage configuration, from storage_list. Example: st_3k9d2m.

Example input: `{"storage_id":"<storage_id>"}`

### `cloudlayer_storage_list`

List Storage Configurations · Read-only

List your S3-compatible storage configurations used to save generated files in your own bucket.
Returns each configuration's id, title, bucket, region and endpoint.
Storage is configured in the cloudlayer.io dashboard.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `cloudlayer_html_to_image`

Convert HTML to Image · Write

Render Base64-encoded HTML to a PNG, JPEG, WebP or SVG image.
Returns the job id and status at once (processing is asynchronous); the file is stored as an asset.
Poll job_get until status is success, then assets_list (match jobId) or asset_get gives the download URL. Uses API credits.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `html` (`string`, required): The HTML to render, Base64-encoded. It can include inline CSS, style tags and links to external stylesheets. Example: PGgxPkhlbGxvIFdvcmxkPC9oMT4=.
- `auto_scroll` (`boolean`, optional): Scroll to the bottom of the page before rendering, to trigger lazy-loaded images. Defaults to false. Example: true.
- `delay` (`integer`, optional): Milliseconds to wait after the page loads before rendering, for animations or late content. Defaults to 0. Example: 500.
- `filename` (`string`, optional): File name for the generated file, with extension. Example: invoice-2026-001.pdf.
- `height` (`string`, optional): Page or image height in CSS units, overriding the format height. Example: 11in.
- `image_type` (`string`, optional): Output image format. Defaults to png. Example: png. One of: `png`, `jpg`, `jpeg`, `webp`, `svg`.
- `landscape` (`boolean`, optional): Render in landscape orientation. Defaults to false. Example: true.
- `project_id` (`string`, optional): cloudlayer.io project ID to file this job under in the dashboard. Example: proj_8f2k1m.
- `quality` (`integer`, optional): Image quality from 1 to 100, for jpg, jpeg and webp only. Example: 85.
- `scale` (`number`, optional): Rendering scale from 0.1 to 2. Defaults to 1. Example: 1.
- `time_zone` (`string`, optional): IANA time zone for the browser while rendering. Example: America/New_York.
- `timeout` (`integer`, optional): Maximum milliseconds to wait for the page to load. Defaults to 30000; the maximum depends on your plan. Example: 30000.
- `transparent` (`boolean`, optional): Render with a transparent background (png and webp only; the page must not set a background color). Defaults to false. Example: false.
- `trim` (`boolean`, optional): Trim whitespace from all edges of the image. Defaults to false. Example: false.
- `view_port` (`object`, optional): Browser viewport: width and height in pixels, plus optional deviceScaleFactor, isMobile, hasTouch and isLandscape. Example: {"width": 1440, "height": 900, "deviceScaleFactor": 2}
- `wait_for_selector` (`object`, optional): Wait until a CSS selector appears before rendering: selector, plus optional options with visible, hidden and timeout. Example: {"selector": "#charts-loaded", "options": {"visible": true, "timeout": 10000}}
- `wait_until` (`string`, optional): When the page counts as loaded. Example: networkidle2. One of: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`.
- `webhook` (`string`, optional): HTTPS URL that cloudlayer.io calls with the job result when it finishes. Example: https://hooks.example.com/cloudlayer.
- `width` (`string`, optional): Page or image width in CSS units, overriding the format width. Example: 8.5in.

Example input: `{"html":"<html>"}`

### `cloudlayer_html_to_pdf`

Convert HTML to PDF · Write

Render Base64-encoded HTML to a PDF.
Returns the job id and status at once (processing is asynchronous); the file is stored as an asset.
Poll job_get until status is success, then assets_list (match jobId) or asset_get gives the download URL. Uses API credits.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `html` (`string`, required): The HTML to render, Base64-encoded. It can include inline CSS, style tags and links to external stylesheets. Example: PGgxPkhlbGxvIFdvcmxkPC9oMT4=.
- `auto_scroll` (`boolean`, optional): Scroll to the bottom of the page before rendering, to trigger lazy-loaded images. Defaults to false. Example: true.
- `delay` (`integer`, optional): Milliseconds to wait after the page loads before rendering, for animations or late content. Defaults to 0. Example: 500.
- `filename` (`string`, optional): File name for the generated file, with extension. Example: invoice-2026-001.pdf.
- `footer_template` (`object`, optional): Page footer: selector of an element in your HTML to use as the footer, plus optional method, style and imageStyle. Elements with class pageNumber or totalPages are filled in. Example: {"selector": "#page-footer", "method": "template"}
- `format` (`string`, optional): Paper size. Defaults to letter. Example: a4. One of: `letter`, `legal`, `tabloid`, `ledger`, `a0`, `a1`, `a2`, `a3`, `a4`, `a5`, `a6`.
- `generate_preview` (`object`, optional): Also generate a thumbnail of the first page: width, height, type (png, jpg or webp), quality and maintainAspectRatio. Example: {"width": 300, "height": 400, "type": "png"}
- `header_template` (`object`, optional): Page header: selector of an element in your HTML to use as the header, plus optional method (template or extract), style and imageStyle. Leave room with margin.top. Example: {"selector": "#page-header", "method": "extract", "style": "font-size: 10px;"}
- `height` (`string`, optional): Page or image height in CSS units, overriding the format height. Example: 11in.
- `landscape` (`boolean`, optional): Render in landscape orientation. Defaults to false. Example: true.
- `margin` (`object`, optional): Page margins in CSS units: top, bottom, left and right. Example: {"top": "1in", "bottom": "1in", "left": "0.75in", "right": "0.75in"}
- `page_ranges` (`string`, optional): Pages to include, such as 1-5 or 1-3, 5. Empty means all pages. Example: 1-3.
- `prefer_css_page_size` (`boolean`, optional): Use the page size from the CSS @page rule instead of format. Defaults to false. Example: false.
- `print_background` (`boolean`, optional): Print background colors and images. Defaults to false. Example: true.
- `project_id` (`string`, optional): cloudlayer.io project ID to file this job under in the dashboard. Example: proj_8f2k1m.
- `scale` (`number`, optional): Rendering scale from 0.1 to 2. Defaults to 1. Example: 1.
- `time_zone` (`string`, optional): IANA time zone for the browser while rendering. Example: America/New_York.
- `timeout` (`integer`, optional): Maximum milliseconds to wait for the page to load. Defaults to 30000; the maximum depends on your plan. Example: 30000.
- `view_port` (`object`, optional): Browser viewport: width and height in pixels, plus optional deviceScaleFactor, isMobile, hasTouch and isLandscape. Example: {"width": 1440, "height": 900, "deviceScaleFactor": 2}
- `wait_for_selector` (`object`, optional): Wait until a CSS selector appears before rendering: selector, plus optional options with visible, hidden and timeout. Example: {"selector": "#charts-loaded", "options": {"visible": true, "timeout": 10000}}
- `wait_until` (`string`, optional): When the page counts as loaded. Example: networkidle2. One of: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`.
- `webhook` (`string`, optional): HTTPS URL that cloudlayer.io calls with the job result when it finishes. Example: https://hooks.example.com/cloudlayer.
- `width` (`string`, optional): Page or image width in CSS units, overriding the format width. Example: 8.5in.

Example input: `{"html":"<html>"}`

### `cloudlayer_template_to_image`

Generate Image from Template · Write

Generate an image from a gallery template or your own Nunjucks template, filled with data.
Returns the job id and status at once (processing is asynchronous); the file is stored as an asset.
Poll job_get until status is success, then assets_list (match jobId) or asset_get gives the download URL. Uses API credits.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `auto_scroll` (`boolean`, optional): Scroll to the bottom of the page before rendering, to trigger lazy-loaded images. Defaults to false. Example: true.
- `data` (`object`, optional): Values for the template's placeholders, keyed by name (for example name fills {{ name }}). Example: {"name": "Jane Doe", "total": "$1,200.00"}
- `delay` (`integer`, optional): Milliseconds to wait after the page loads before rendering, for animations or late content. Defaults to 0. Example: 500.
- `filename` (`string`, optional): File name for the generated file, with extension. Example: invoice-2026-001.pdf.
- `height` (`string`, optional): Page or image height in CSS units, overriding the format height. Example: 11in.
- `image_type` (`string`, optional): Output image format. Defaults to png. Example: png. One of: `png`, `jpg`, `jpeg`, `webp`, `svg`.
- `landscape` (`boolean`, optional): Render in landscape orientation. Defaults to false. Example: true.
- `project_id` (`string`, optional): cloudlayer.io project ID to file this job under in the dashboard. Example: proj_8f2k1m.
- `quality` (`integer`, optional): Image quality from 1 to 100, for jpg, jpeg and webp only. Example: 85.
- `scale` (`number`, optional): Rendering scale from 0.1 to 2. Defaults to 1. Example: 1.
- `template` (`string`, optional): Your own Nunjucks HTML template, Base64-encoded. Pass this or templateId. Example: PGgxPnt7IG5hbWUgfX08L2gxPg==.
- `template_id` (`string`, optional): ID of a template from the cloudlayer.io template gallery. Pass this or template. Example: professional-invoice.
- `time_zone` (`string`, optional): IANA time zone for the browser while rendering. Example: America/New_York.
- `timeout` (`integer`, optional): Maximum milliseconds to wait for the page to load. Defaults to 30000; the maximum depends on your plan. Example: 30000.
- `transparent` (`boolean`, optional): Render with a transparent background (png and webp only; the page must not set a background color). Defaults to false. Example: false.
- `trim` (`boolean`, optional): Trim whitespace from all edges of the image. Defaults to false. Example: false.
- `view_port` (`object`, optional): Browser viewport: width and height in pixels, plus optional deviceScaleFactor, isMobile, hasTouch and isLandscape. Example: {"width": 1440, "height": 900, "deviceScaleFactor": 2}
- `wait_for_selector` (`object`, optional): Wait until a CSS selector appears before rendering: selector, plus optional options with visible, hidden and timeout. Example: {"selector": "#charts-loaded", "options": {"visible": true, "timeout": 10000}}
- `wait_until` (`string`, optional): When the page counts as loaded. Example: networkidle2. One of: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`.
- `webhook` (`string`, optional): HTTPS URL that cloudlayer.io calls with the job result when it finishes. Example: https://hooks.example.com/cloudlayer.
- `width` (`string`, optional): Page or image width in CSS units, overriding the format width. Example: 8.5in.

Example input: `{}`

### `cloudlayer_template_to_pdf`

Generate PDF from Template · Write

Generate a PDF from a gallery template or your own Nunjucks template, filled with data.
Returns the job id and status at once (processing is asynchronous); the file is stored as an asset.
Poll job_get until status is success, then assets_list (match jobId) or asset_get gives the download URL. Uses API credits.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `auto_scroll` (`boolean`, optional): Scroll to the bottom of the page before rendering, to trigger lazy-loaded images. Defaults to false. Example: true.
- `data` (`object`, optional): Values for the template's placeholders, keyed by name (for example name fills {{ name }}). Example: {"name": "Jane Doe", "total": "$1,200.00"}
- `delay` (`integer`, optional): Milliseconds to wait after the page loads before rendering, for animations or late content. Defaults to 0. Example: 500.
- `filename` (`string`, optional): File name for the generated file, with extension. Example: invoice-2026-001.pdf.
- `footer_template` (`object`, optional): Page footer: selector of an element in your HTML to use as the footer, plus optional method, style and imageStyle. Elements with class pageNumber or totalPages are filled in. Example: {"selector": "#page-footer", "method": "template"}
- `format` (`string`, optional): Paper size. Defaults to letter. Example: a4. One of: `letter`, `legal`, `tabloid`, `ledger`, `a0`, `a1`, `a2`, `a3`, `a4`, `a5`, `a6`.
- `generate_preview` (`object`, optional): Also generate a thumbnail of the first page: width, height, type (png, jpg or webp), quality and maintainAspectRatio. Example: {"width": 300, "height": 400, "type": "png"}
- `header_template` (`object`, optional): Page header: selector of an element in your HTML to use as the header, plus optional method (template or extract), style and imageStyle. Leave room with margin.top. Example: {"selector": "#page-header", "method": "extract", "style": "font-size: 10px;"}
- `height` (`string`, optional): Page or image height in CSS units, overriding the format height. Example: 11in.
- `landscape` (`boolean`, optional): Render in landscape orientation. Defaults to false. Example: true.
- `margin` (`object`, optional): Page margins in CSS units: top, bottom, left and right. Example: {"top": "1in", "bottom": "1in", "left": "0.75in", "right": "0.75in"}
- `page_ranges` (`string`, optional): Pages to include, such as 1-5 or 1-3, 5. Empty means all pages. Example: 1-3.
- `prefer_css_page_size` (`boolean`, optional): Use the page size from the CSS @page rule instead of format. Defaults to false. Example: false.
- `print_background` (`boolean`, optional): Print background colors and images. Defaults to false. Example: true.
- `project_id` (`string`, optional): cloudlayer.io project ID to file this job under in the dashboard. Example: proj_8f2k1m.
- `scale` (`number`, optional): Rendering scale from 0.1 to 2. Defaults to 1. Example: 1.
- `template` (`string`, optional): Your own Nunjucks HTML template, Base64-encoded. Pass this or templateId. Example: PGgxPnt7IG5hbWUgfX08L2gxPg==.
- `template_id` (`string`, optional): ID of a template from the cloudlayer.io template gallery. Pass this or template. Example: professional-invoice.
- `time_zone` (`string`, optional): IANA time zone for the browser while rendering. Example: America/New_York.
- `timeout` (`integer`, optional): Maximum milliseconds to wait for the page to load. Defaults to 30000; the maximum depends on your plan. Example: 30000.
- `view_port` (`object`, optional): Browser viewport: width and height in pixels, plus optional deviceScaleFactor, isMobile, hasTouch and isLandscape. Example: {"width": 1440, "height": 900, "deviceScaleFactor": 2}
- `wait_for_selector` (`object`, optional): Wait until a CSS selector appears before rendering: selector, plus optional options with visible, hidden and timeout. Example: {"selector": "#charts-loaded", "options": {"visible": true, "timeout": 10000}}
- `wait_until` (`string`, optional): When the page counts as loaded. Example: networkidle2. One of: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`.
- `webhook` (`string`, optional): HTTPS URL that cloudlayer.io calls with the job result when it finishes. Example: https://hooks.example.com/cloudlayer.
- `width` (`string`, optional): Page or image width in CSS units, overriding the format width. Example: 8.5in.

Example input: `{}`

### `cloudlayer_url_to_image`

Capture URL as Image · Write

Take a screenshot of a web page at a URL as a PNG, JPEG, WebP or SVG image.
Returns the job id and status at once (processing is asynchronous); the file is stored as an asset.
Poll job_get until status is success, then assets_list (match jobId) or asset_get gives the download URL. Uses API credits.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `url` (`string`, required): The URL of the web page to capture. Example: https://example.com/report.
- `authentication` (`object`, optional): HTTP Basic Authentication credentials for the page: username and password. Example: {"username": "viewer", "password": "s3cret"}
- `auto_scroll` (`boolean`, optional): Scroll to the bottom of the page before rendering, to trigger lazy-loaded images. Defaults to false. Example: true.
- `cookies` (`array`, optional): Cookies to set before loading the page. Each has name and value, plus optional domain, path, expires, httpOnly, secure and sameSite. Example: [{"name": "session", "value": "abc123", "domain": "example.com"}]
- `delay` (`integer`, optional): Milliseconds to wait after the page loads before rendering, for animations or late content. Defaults to 0. Example: 500.
- `filename` (`string`, optional): File name for the generated file, with extension. Example: invoice-2026-001.pdf.
- `height` (`string`, optional): Page or image height in CSS units, overriding the format height. Example: 11in.
- `image_type` (`string`, optional): Output image format. Defaults to png. Example: png. One of: `png`, `jpg`, `jpeg`, `webp`, `svg`.
- `landscape` (`boolean`, optional): Render in landscape orientation. Defaults to false. Example: true.
- `project_id` (`string`, optional): cloudlayer.io project ID to file this job under in the dashboard. Example: proj_8f2k1m.
- `quality` (`integer`, optional): Image quality from 1 to 100, for jpg, jpeg and webp only. Example: 85.
- `scale` (`number`, optional): Rendering scale from 0.1 to 2. Defaults to 1. Example: 1.
- `time_zone` (`string`, optional): IANA time zone for the browser while rendering. Example: America/New_York.
- `timeout` (`integer`, optional): Maximum milliseconds to wait for the page to load. Defaults to 30000; the maximum depends on your plan. Example: 30000.
- `transparent` (`boolean`, optional): Render with a transparent background (png and webp only; the page must not set a background color). Defaults to false. Example: false.
- `trim` (`boolean`, optional): Trim whitespace from all edges of the image. Defaults to false. Example: false.
- `view_port` (`object`, optional): Browser viewport: width and height in pixels, plus optional deviceScaleFactor, isMobile, hasTouch and isLandscape. Example: {"width": 1440, "height": 900, "deviceScaleFactor": 2}
- `wait_for_selector` (`object`, optional): Wait until a CSS selector appears before rendering: selector, plus optional options with visible, hidden and timeout. Example: {"selector": "#charts-loaded", "options": {"visible": true, "timeout": 10000}}
- `wait_until` (`string`, optional): When the page counts as loaded. Example: networkidle2. One of: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`.
- `webhook` (`string`, optional): HTTPS URL that cloudlayer.io calls with the job result when it finishes. Example: https://hooks.example.com/cloudlayer.
- `width` (`string`, optional): Page or image width in CSS units, overriding the format width. Example: 8.5in.

Example input: `{"url":"<url>"}`

### `cloudlayer_url_to_pdf`

Convert URL to PDF · Write

Capture a web page at a URL as a PDF, with optional cookies and Basic auth.
Returns the job id and status at once (processing is asynchronous); the file is stored as an asset.
Poll job_get until status is success, then assets_list (match jobId) or asset_get gives the download URL. Uses API credits.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `url` (`string`, required): The URL of the web page to capture. Example: https://example.com/report.
- `authentication` (`object`, optional): HTTP Basic Authentication credentials for the page: username and password. Example: {"username": "viewer", "password": "s3cret"}
- `auto_scroll` (`boolean`, optional): Scroll to the bottom of the page before rendering, to trigger lazy-loaded images. Defaults to false. Example: true.
- `cookies` (`array`, optional): Cookies to set before loading the page. Each has name and value, plus optional domain, path, expires, httpOnly, secure and sameSite. Example: [{"name": "session", "value": "abc123", "domain": "example.com"}]
- `delay` (`integer`, optional): Milliseconds to wait after the page loads before rendering, for animations or late content. Defaults to 0. Example: 500.
- `filename` (`string`, optional): File name for the generated file, with extension. Example: invoice-2026-001.pdf.
- `footer_template` (`object`, optional): Page footer: selector of an element in your HTML to use as the footer, plus optional method, style and imageStyle. Elements with class pageNumber or totalPages are filled in. Example: {"selector": "#page-footer", "method": "template"}
- `format` (`string`, optional): Paper size. Defaults to letter. Example: a4. One of: `letter`, `legal`, `tabloid`, `ledger`, `a0`, `a1`, `a2`, `a3`, `a4`, `a5`, `a6`.
- `generate_preview` (`object`, optional): Also generate a thumbnail of the first page: width, height, type (png, jpg or webp), quality and maintainAspectRatio. Example: {"width": 300, "height": 400, "type": "png"}
- `header_template` (`object`, optional): Page header: selector of an element in your HTML to use as the header, plus optional method (template or extract), style and imageStyle. Leave room with margin.top. Example: {"selector": "#page-header", "method": "extract", "style": "font-size: 10px;"}
- `height` (`string`, optional): Page or image height in CSS units, overriding the format height. Example: 11in.
- `landscape` (`boolean`, optional): Render in landscape orientation. Defaults to false. Example: true.
- `margin` (`object`, optional): Page margins in CSS units: top, bottom, left and right. Example: {"top": "1in", "bottom": "1in", "left": "0.75in", "right": "0.75in"}
- `page_ranges` (`string`, optional): Pages to include, such as 1-5 or 1-3, 5. Empty means all pages. Example: 1-3.
- `prefer_css_page_size` (`boolean`, optional): Use the page size from the CSS @page rule instead of format. Defaults to false. Example: false.
- `print_background` (`boolean`, optional): Print background colors and images. Defaults to false. Example: true.
- `project_id` (`string`, optional): cloudlayer.io project ID to file this job under in the dashboard. Example: proj_8f2k1m.
- `scale` (`number`, optional): Rendering scale from 0.1 to 2. Defaults to 1. Example: 1.
- `time_zone` (`string`, optional): IANA time zone for the browser while rendering. Example: America/New_York.
- `timeout` (`integer`, optional): Maximum milliseconds to wait for the page to load. Defaults to 30000; the maximum depends on your plan. Example: 30000.
- `view_port` (`object`, optional): Browser viewport: width and height in pixels, plus optional deviceScaleFactor, isMobile, hasTouch and isLandscape. Example: {"width": 1440, "height": 900, "deviceScaleFactor": 2}
- `wait_for_selector` (`object`, optional): Wait until a CSS selector appears before rendering: selector, plus optional options with visible, hidden and timeout. Example: {"selector": "#charts-loaded", "options": {"visible": true, "timeout": 10000}}
- `wait_until` (`string`, optional): When the page counts as loaded. Example: networkidle2. One of: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`.
- `webhook` (`string`, optional): HTTPS URL that cloudlayer.io calls with the job result when it finishes. Example: https://hooks.example.com/cloudlayer.
- `width` (`string`, optional): Page or image width in CSS units, overriding the format width. Example: 8.5in.

Example input: `{"url":"<url>"}`

### `cloudlayer_storage_delete`

Delete Storage Configuration · Destructive

Delete an S3-compatible storage configuration.
Returns the result.
Files already in your bucket are not deleted.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `storage_id` (`string`, required): ID of the storage configuration, from storage_list. Example: st_3k9d2m.

Example input: `{"storage_id":"<storage_id>"}`

## Related

Other Files & Documents connectors ([all 76](/agentkit/connectors/?category=files-documents)):

- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Google Sheets](/agentkit/connectors/googlesheets/): Scalekit connector, OAuth, 48 tools
- [Google Drive](/agentkit/connectors/googledrive/): Scalekit connector, OAuth, 47 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
