---
canonical_url: "https://docs.composio.dev/toolkits/agent37"
markdown_url: "https://docs.composio.dev/toolkits/agent37.md"
product: "platform"
version: null
last_updated: null
---

# Agent37

Agent37 provides managed agent sandboxes, templates, networking, execution, scheduling, observability, budgets, and workspace administration through its Control API.

- **Category:** ai agents
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 60
- **Triggers:** 0
- **Slug:** `AGENT37`
- **Version:** 00000000_00

## Tools

### Connect Integration

**Slug:** `AGENT37_CONNECT_INTEGRATION`

Start a managed OAuth connection for one toolkit on an Agent37 instance. This creates a pending connected account and returns a browser authorization URL; the agent can return the URL, but a human must complete OAuth outside this action. Afterwards, list connections and confirm the account is ACTIVE.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `toolkit` | string | Yes | Toolkit slug from List Integration Toolkits to connect. |
| `instance_id` | string | Yes | Instance ID to which the connected account will belong. |
| `callback_url` | string | No | Absolute HTTPS page to which the user returns after the provider OAuth screens. Omit to use Composio's hosted completion page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Billing Top Up

**Slug:** `AGENT37_CREATE_BILLING_TOP_UP`

Create a Stripe Checkout URL to fund the connected Agent37 workspace with a real payment. This call does not itself move money; payment occurs when a person opens and completes the returned payment-sensitive Checkout URL. Treat that URL as private; completion also saves the card and enables Agent37's default automatic top-up rule.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `amount_usd` | number | Yes | Amount in US dollars to add, from 5 through 10000. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Cron

**Slug:** `AGENT37_CREATE_CRON`

Schedule a recurring Agent37 prompt on an instance using a five-field cron expression and IANA timezone. Each firing can wake the instance and incur compute or managed-service costs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Optional human-readable schedule name, up to 80 characters. |
| `agent` | string ("hermes" | "openclaw" | "claude-code" | "codex" | "opencode" | "grok" | "pi") | No | Agent harness to invoke; omit to use the instance template's agent. |
| `prompt` | string | Yes | Agent message to run at each scheduled firing, up to 8,000 characters. |
| `enabled` | boolean | No | Whether the schedule should begin firing after creation. |
| `profile` | string | No | Agent profile to use; omit to use the agent's default profile. |
| `schedule` | string | Yes | Five-field cron expression with no seconds field. |
| `timezone` | string | No | IANA timezone used to interpret the cron expression. |
| `instance_id` | string | Yes | Instance ID on which to create the recurring schedule. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Instance

**Slug:** `AGENT37_CREATE_INSTANCE`

Create a persistent Agent37 sandbox from a template. This can start billable compute; use GET_BILLING first when cost or available balance is uncertain. If public_ports is provided, those ports are exposed permanently to the public internet with no authentication; use it only for services intended for unauthenticated access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `env` | object | No | Environment variables for the instance. Keys must begin with a letter and contain only uppercase letters, digits, and underscores. |
| `name` | string | No | Human-readable label for the instance. |
| `type` | string ("default" | "vm" | "performance") | No | Runtime class. VM and performance instances require a funded workspace and cost more than default instances. |
| `budget` | object | No | Optional managed-service monthly cap and one-time credit, in micros. |
| `region` | string ("us" | "eu" | "ap-south") | No | Region in which to create the instance. The region is fixed for the instance's lifetime; omit to use us. |
| `network` | string | No | Outbound network policy: allow-all, deny-all, or an object containing an allow list. |
| `metadata` | object | No | Caller-defined key/value metadata stored without interpretation. |
| `template` | string | No | System or workspace template name, optionally pinned as name@version; omit to use agent37-base. |
| `resources` | object | No | Optional requested CPU, memory, and persistent disk allocation. |
| `auto_sleep` | boolean | No | Whether to checkpoint the instance and release compute after it is idle. |
| `mount_path` | string | No | Absolute non-root path at which to mount persistent data. It is fixed for the instance's lifetime. |
| `public_ports` | array | No | Ports to expose permanently to the public internet during creation. Anyone with a URL can access these ports without authentication; only use this for services intentionally open to unauthenticated callers. Prefer signed URLs for temporary or authenticated access. |
| `idle_timeout_seconds` | integer | No | Idle time in seconds before auto-sleep, from 300 through 86400. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Instance Backup

**Slug:** `AGENT37_CREATE_INSTANCE_BACKUP`

Create a live, crash-consistent manual backup without pausing the instance. The call can take minutes, a client timeout does not cancel it, and creating a new manual backup replaces the previous manual restore point.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `instance_id` | string | Yes | ID of the instance to back up. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Public Port

**Slug:** `AGENT37_CREATE_PUBLIC_PORT`

Permanently expose one instance port at an unauthenticated HTTPS URL until the mapping is deleted. Anyone with the URL can reach the service, public traffic can wake the instance and keep compute billing active, and prefix URLs are guessable; put application authentication in front of sensitive services.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `port` | integer | Yes | Container TCP port to expose permanently; port 22022 is reserved for SSH. |
| `label` | string | No | Optional cosmetic display label, up to 64 characters. |
| `prefix` | string | No | Optional deterministic hostname prefix of 1-30 lowercase letters, digits, or hyphens, with no leading or trailing hyphen. Prefix URLs are guessable. |
| `instance_id` | string | Yes | Instance ID whose container port will be exposed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Signed URL

**Slug:** `AGENT37_CREATE_SIGNED_URL`

Create a time-limited authenticated browser URL for one port on an Agent37 instance without making the port permanently public. The returned URLs contain expiring credentials and must be handled as secrets.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `port` | integer | Yes | TCP port to expose through the signed URL. Port 22022 is reserved for SSH and cannot use a signed URL. |
| `instance_id` | string | Yes | Instance ID hosting the target service. |
| `ttl_seconds` | integer | No | Requested URL lifetime in seconds. Agent37 clamps values to 60 through 604800 seconds; omit to use 3600 seconds. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Template

**Slug:** `AGENT37_CREATE_TEMPLATE`

Register a workspace template by copying and privately pinning a linux/amd64 registry image. This can take several minutes and stores a private image snapshot.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Workspace template name. The reserved agent37- prefix cannot be used. |
| `image_ref` | string | Yes | Fully qualified linux/amd64 image reference with a registry or namespace path. |
| `entrypoint` | array | No | Non-empty command argument array replacing the image ENTRYPOINT and CMD. Omit to use the image default. |
| `description` | string | No | Optional free-text template description. Omit when no description is needed; null is not accepted. |
| `default_port` | integer | No | Main service port for the bare instance URL. Omit for the 3737 fallback; port 22022 is reserved. |
| `registry_auth` | object | No | One-time private-registry login object with exactly two keys: username and password. The password value may be an access token. Omit for a public image; null and empty values are not accepted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Template Build

**Slug:** `AGENT37_CREATE_TEMPLATE_BUILD`

Create an Agent37 cloud-build record and a one-hour presigned URL for uploading the gzipped build context. The returned upload URL is a bearer credential and must not be logged or shared.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Workspace template name that the successful build will publish. |
| `size_bytes` | integer | Yes | Exact byte size of the gzipped build context, from 1 through 1,000,000,000. |
| `description` | string | No | Optional description for the published template. Omit when not needed; null is not accepted. |
| `default_port` | integer | No | Main service port for the published template. Omit for the 3737 fallback; null is not accepted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Cron

**Slug:** `AGENT37_DELETE_CRON`

Permanently delete one recurring Agent37 schedule from an instance. This destructive action cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cron_id` | string | Yes | Cron ID of the recurring schedule to permanently delete. |
| `instance_id` | string | Yes | Instance ID that owns the recurring schedule. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Domain

**Slug:** `AGENT37_DELETE_DOMAIN`

Permanently remove a custom domain, stop all routing under it within seconds, and release its full nameserver delegation from Agent37 DNS hosting. Custom-domain registration is a paid feature requiring $50 in cumulative workspace top-ups. This destructive operation acts once and does not affect agent37.app URLs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | Registered custom domain to permanently remove from Agent37. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Instance

**Slug:** `AGENT37_DELETE_INSTANCE`

Permanently delete one Agent37 instance and its retained disk, stopping its billing. This destructive action cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `instance_id` | string | Yes | ID of the instance to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Member

**Slug:** `AGENT37_DELETE_MEMBER`

Destructively remove a person from the connected Agent37 workspace or revoke a pending invitation. Member access is revoked immediately, but resources they created and API keys they minted remain. Revoking an invitation makes its link unusable. This cannot remove the workspace's last admin.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `member_id` | string | Yes | Member user ID or pending invitation ID to remove or revoke. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Public Port

**Slug:** `AGENT37_DELETE_PUBLIC_PORT`

Permanently delete one public-port mapping and revoke its unauthenticated URL within seconds. This destructive operation acts once; repeating it returns 404, and deleting it does not invalidate separately minted signed URLs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `port` | integer | Yes | Container port whose permanent public URL should be revoked. |
| `instance_id` | string | Yes | Instance ID that owns the public-port mapping. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete SSH Key

**Slug:** `AGENT37_DELETE_SSH_KEY`

Revoke one SSH key from every instance in the workspace. Revocation reaches running instances within about two minutes and blocks new logins, but an already-open SSH session continues until it exits; stop or restart affected instances when immediate session termination is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ssh_key_id` | string | Yes | Exact 24-character lowercase hexadecimal ID of the SSH key to revoke. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Template

**Slug:** `AGENT37_DELETE_TEMPLATE`

Permanently delete a workspace template. This destructive action cannot be undone, although existing instances created from the template keep running.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_name` | string | Yes | Workspace template name to permanently remove. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Disconnect Integration

**Slug:** `AGENT37_DISCONNECT_INTEGRATION`

Permanently remove one connected app account from an Agent37 instance. The agent can no longer use that account; other connections are untouched.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `instance_id` | string | Yes | Instance ID that owns the connected account. |
| `connected_account_id` | string | Yes | Connected-account ID to permanently remove from the instance. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Execute Command

**Slug:** `AGENT37_EXECUTE_COMMAND`

Run a shell command inside an instance, either waiting for stdout, stderr, and exit code or starting it in the background.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Optional idempotency label for the execution. |
| `user` | string | No | Run as root; omit to use the image's default operating-system user. |
| `command` | string | Yes | Shell command to execute inside the instance. |
| `background` | boolean | No | Start the command asynchronously and return its process ID instead of waiting. |
| `instance_id` | string | Yes | Instance ID in which to run the command. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Fork Instance

**Slug:** `AGENT37_FORK_INSTANCE`

Create an independent instance by copying a source instance's image and disk. The source remains unchanged; the new instance has separate billing, budget, ID, URLs, and files and may start billable compute.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Name for the fork; omit it to copy the source name. |
| `metadata` | object | No | Metadata for the fork; omit it to copy the source metadata. |
| `resources` | object | No | Optional resource allocation for the new instance. |
| `auto_sleep` | boolean | No | Auto-sleep setting for the fork; omit it to copy the source setting. |
| `instance_id` | string | Yes | ID of the source instance to copy. |
| `idle_timeout_seconds` | integer | No | Idle seconds before auto-sleep, from 300 through 86400. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Billing

**Slug:** `AGENT37_GET_BILLING`

Read the connected workspace's wallet balance, numeric billing tier, memory and instance limits, automatic refill rule, and payment status.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Cron

**Slug:** `AGENT37_GET_CRON`

Get the complete configuration of one recurring schedule on an instance.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cron_id` | string | Yes | Cron ID returned by CREATE_CRON or LIST_CRONS. |
| `instance_id` | string | Yes | Instance ID that owns the recurring schedule. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Domain

**Slug:** `AGENT37_GET_DOMAIN`

Read one custom domain's status and full nameserver delegation. Registration is a paid feature requiring $50 in cumulative workspace top-ups, the whole dedicated domain must use Agent37's nameservers, and active public-port mirrors are unauthenticated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | Registered custom domain to read. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Instance

**Slug:** `AGENT37_GET_INSTANCE`

Get the configuration, resource allocation, URLs, and current lifecycle state of one instance.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `instance_id` | string | Yes | Instance ID returned by CREATE_INSTANCE or LIST_INSTANCES. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Instance Budget

**Slug:** `AGENT37_GET_INSTANCE_BUDGET`

Read one instance's managed-service monthly cap, consumption, remaining allowance, and one-time credit balance in provider-native micros.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `instance_id` | string | Yes | Instance ID whose managed-service budget should be read. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Instance Events

**Slug:** `AGENT37_GET_INSTANCE_EVENTS`

Read an Agent37 instance's start, sleep, wake, and stop history over an optional inclusive date window of at most 90 days.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to_date` | string | No | Inclusive final UTC date in YYYY-MM-DD format; omit it to use today. When both dates are set, the window may contain at most 90 days. |
| `from_date` | string | No | Inclusive first UTC date in YYYY-MM-DD format; omit it to use the provider default. |
| `instance_id` | string | Yes | Instance ID whose lifecycle history should be read. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Instance Usage

**Slug:** `AGENT37_GET_INSTANCE_USAGE`

Read one UTC month's managed-service spend for an Agent37 instance, broken down across language models, search, Composio, and paid tools.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `month` | string | No | UTC calendar month formatted YYYY-MM. Omit to read the current month. |
| `instance_id` | string | Yes | Instance ID whose monthly managed-service usage should be read. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Template

**Slug:** `AGENT37_GET_TEMPLATE`

Get one Agent37 template or pinned template revision, including its image, installed agents, entrypoint, defaults, and workspace revision history.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_name` | string | Yes | Template name or pinned name@revision returned by LIST_TEMPLATES. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Template Build

**Slug:** `AGENT37_GET_TEMPLATE_BUILD`

Get a template build's current status, timestamps, failure details, and published template result. Polling a completed build can trigger final template registration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `build_id` | string | Yes | Template build ID returned by CREATE_TEMPLATE_BUILD. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Template Build Logs

**Slug:** `AGENT37_GET_TEMPLATE_BUILD_LOGS`

Read an incremental chunk of a template build's Docker output and return the next byte offset for tailing, together with current build status and failure details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `offset` | integer | No | Byte offset at which to begin this log chunk. Pass the previous response's offset to tail incrementally. |
| `build_id` | string | Yes | Template build ID returned by CREATE_TEMPLATE_BUILD. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Workspace Usage

**Slug:** `AGENT37_GET_WORKSPACE_USAGE`

Read Agent37 workspace spend over an inclusive date window, with daily, instance, model, and integration breakdowns. Omit dates to use the provider's defaults.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to_date` | string | No | Inclusive final UTC date in YYYY-MM-DD format; omit to use today. When both dates are set, the window may contain at most 90 days. |
| `from_date` | string | No | Inclusive first UTC date in YYYY-MM-DD format; omit to use the provider default. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Invite Member

**Slug:** `AGENT37_INVITE_MEMBER`

Send an email invitation to join the connected Agent37 workspace as an admin or user. This does not add the person immediately; they must accept the invitation. A workspace created through API signup must be funded before it can send member invitations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role` | string ("admin" | "user") | No | Role granted after acceptance. Admin can manage instances, keys, billing, and the team; user can use workspace apps only. |
| `email` | string | Yes | Email address to which Agent37 sends the workspace invitation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Cron Runs

**Slug:** `AGENT37_LIST_CRON_RUNS`

List the latest 50 firings of one Agent37 cron, newest first, including whether each turn started, its session ID, and any skip reason.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cron_id` | string | Yes | Cron ID whose latest firings should be listed. |
| `instance_id` | string | Yes | Instance ID that owns the recurring schedule. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Crons

**Slug:** `AGENT37_LIST_CRONS`

List all recurring Agent37 schedules on an instance, oldest first.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `instance_id` | string | Yes | Instance ID whose recurring schedules should be listed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Domains

**Slug:** `AGENT37_LIST_DOMAINS`

List the workspace's custom domains and the nameservers each dedicated domain must fully delegate to Agent37. Domain registration is a paid feature requiring $50 in cumulative workspace top-ups; active public-port mirrors remain unauthenticated.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Instance Backups

**Slug:** `AGENT37_LIST_INSTANCE_BACKUPS`

List all retained automatic and manual restore points for an instance, newest first, including IDs, timestamps, and compressed sizes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `instance_id` | string | Yes | ID of the instance whose restore points should be listed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Instances

**Slug:** `AGENT37_LIST_INSTANCES`

List all instances in the connected workspace, newest first, including their IDs, configuration, URLs, resource allocation, and lifecycle state.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Integration Connections

**Slug:** `AGENT37_LIST_INTEGRATION_CONNECTIONS`

List app accounts attached to an Agent37 instance, optionally for one toolkit. Use status and statusReason to confirm whether a pending OAuth handoff became ACTIVE or failed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `toolkit` | string | No | Return only accounts for this toolkit slug. |
| `instance_id` | string | Yes | Instance ID whose connected app accounts should be listed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Integration Toolkits

**Slug:** `AGENT37_LIST_INTEGRATION_TOOLKITS`

Browse one cursor-paginated page of apps that can be connected to an Agent37 instance. Pass nextCursor back as cursor to continue.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum toolkits in this page (1-24). |
| `cursor` | string | No | Opaque nextCursor from a previous page; omit for the first page. |
| `search` | string | No | Filter toolkit names and slugs. Agent37 requires at least 3 characters. |
| `instance_id` | string | Yes | Instance ID whose managed integration catalog should be browsed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Members

**Slug:** `AGENT37_LIST_MEMBERS`

List all people in the connected Agent37 workspace and every pending email invitation, including IDs suitable for removal or invitation revocation.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Public Ports

**Slug:** `AGENT37_LIST_PUBLIC_PORTS`

List an instance's permanent public HTTPS mappings. Every listed URL accepts traffic without Agent37 credentials and remains reachable until its mapping is deleted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `instance_id` | string | Yes | Instance ID whose permanent public-port mappings should be listed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List SSH Keys

**Slug:** `AGENT37_LIST_SSH_KEYS`

Audit up to 20 SSH public-key fingerprints registered for workspace-wide access, newest first. Agent37 does not return public-key blobs or any private key material.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Templates

**Slug:** `AGENT37_LIST_TEMPLATES`

List system and workspace templates that can be used to create an instance.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Read Instance Logs

**Slug:** `AGENT37_READ_INSTANCE_LOGS`

Read recent container output and compact runtime health for an instance without waking it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tail` | integer | No | Number of recent log lines to request. Agent37 caps the result at 2000 lines. |
| `instance_id` | string | Yes | Instance ID whose container output should be read. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Read Instance Metrics

**Slug:** `AGENT37_READ_INSTANCE_METRICS`

Read recent CPU, memory, and disk history and configured resource limits for an instance without waking it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hours` | integer | No | Recent metric-history window in whole hours, from 1 through 336. |
| `instance_id` | string | Yes | Instance ID whose resource history should be read. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Register Domain

**Slug:** `AGENT37_REGISTER_DOMAIN`

Register a dedicated custom domain for the workspace. This paid feature requires at least $50 in cumulative workspace top-ups; registration requires ownership of a registrable domain and returns nameservers that must replace the domain's entire existing DNS delegation, so do not use a domain needed for a website, mail, or other records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | Dedicated registrable domain you own, without a wildcard or subdomain. Its entire DNS zone must be delegated to Agent37. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Register SSH Key

**Slug:** `AGENT37_REGISTER_SSH_KEY`

Register one OpenSSH public key for workspace-wide shell access. The key can authenticate to every current and future instance in the connected workspace, including root login, until revoked; register only a trusted public key and never submit private-key material. A workspace accepts at most 20 distinct fingerprints.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Optional key label. When omitted, Agent37 uses the public key's trailing comment, or null when the key has no comment. |
| `public_key` | string | Yes | One complete OpenSSH public-key line from a .pub file. Accepted types: ssh-ed25519, ssh-rsa, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521, sk-ssh-ed25519@openssh.com, and sk-ecdsa-sha2-nistp256@openssh.com. Never provide a private key. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resize Instance

**Slug:** `AGENT37_RESIZE_INSTANCE`

Change a running instance's CPU, memory, or disk while retaining its ID, URLs, and files. This recreates the container, loses in-memory state, changes billing immediately, and disk growth cannot be reversed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cpu` | integer ("1" | "2" | "4" | "8") | No | Target virtual CPU count. Use 1, 2, or 4 for any compatible shape; 8 is available only with 64 GB of memory on VM or Performance instances. |
| `disk` | integer | No | Target disk size in gigabytes. Disk may grow but cannot shrink. |
| `memory` | integer | No | Target memory in gigabytes. |
| `instance_id` | string | Yes | ID of the instance to resize. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Restore Instance Backup

**Slug:** `AGENT37_RESTORE_INSTANCE_BACKUP`

Destructively replace an instance's current disk data with a retained backup. Files written after the backup and in-memory state are permanently lost; create a backup first if the current state may be needed. Do not retry after a client timeout; poll the instance until it leaves updating.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `backup_id` | string | Yes | Backup ID returned by LIST_INSTANCE_BACKUPS. |
| `instance_id` | string | Yes | ID of the instance to restore in place. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Run Cron Now

**Slug:** `AGENT37_RUN_CRON_NOW`

Trigger one Agent37 cron immediately without changing its recurring schedule. This fire-and-forget action starts agent work and may incur compute or managed-service costs; a triggered response does not mean the work succeeded.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cron_id` | string | Yes | Cron ID to trigger immediately. |
| `instance_id` | string | Yes | Instance ID that owns the recurring schedule. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Feedback

**Slug:** `AGENT37_SEND_FEEDBACK`

Send external feedback to the Agent37 team about a bug, feature request, or documentation gap. A person at Agent37 reads the submitted message, but this endpoint sends no reply and is not a support channel. Do not include secrets or API keys.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `kind` | string ("bug" | "feature" | "docs" | "other") | No | Feedback category. |
| `message` | string | Yes | Plain-text feedback sent externally to Agent37, from 1 through 4000 characters. Include what was attempted, observed, and expected; never include secrets or API keys. |
| `instance_id` | string | No | Related instance ID, which must belong to the connected workspace. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Instance Budget

**Slug:** `AGENT37_SET_INSTANCE_BUDGET`

Replace an instance's monthly managed-service spending ceiling, effective immediately and for future UTC months. Raising this ceiling moves no funds, but authorizes the instance to consume more of the workspace wallet through managed LLM, Brave, Composio, and Perflo calls; inspect current budget, usage, and wallet balance before increasing it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `instance_id` | string | Yes | Exact bare 10-character lowercase alphanumeric instance ID. |
| `monthly_cap_micros` | integer | Yes | New monthly managed-service spending ceiling in integer millionths of a US dollar. Zero disables monthly headroom after any one-time credit is consumed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Instance Power State

**Slug:** `AGENT37_SET_INSTANCE_POWER_STATE`

Start, stop, sleep, or restart an instance. Starting or restarting can resume billable compute; sleeping checkpoints state and releases CPU and memory.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `action` | string ("start" | "stop" | "sleep" | "restart") | Yes | Lifecycle transition to request: start or wake, stop while retaining disk, sleep with a checkpoint, or restart in place. |
| `instance_id` | string | Yes | Instance ID whose power state should change. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Sign Up Workspace

**Slug:** `AGENT37_SIGN_UP_WORKSPACE`

Create a separate Agent37 workspace, empty wallet, owner claim invitation, and full workspace API key. Every call creates a new workspace and the key is shown only once. The provider endpoint is unauthenticated, but this action is available through the connected API-key toolkit and uses its shared transport; Agent37 accepts or ignores the connected Authorization header. Immediately store the returned API key as a secret and disclose the single-use admin claim URL only to the intended owner. Signup itself charges nothing, but the payment-sensitive Checkout URL can make a real payment and must be shared only with the intended payer.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Workspace name, up to 100 characters; omit to derive it from email. |
| `email` | string | Yes | Contact email for the workspace owner and the address to which the returned one-time claim link is scoped. Agent37 does not verify it or send email during signup. |
| `top_up_usd` | number | No | Amount in US dollars, from 5 through 10000, for the returned Stripe Checkout link. Signup does not charge this amount. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start Template Build

**Slug:** `AGENT37_START_TEMPLATE_BUILD`

Start a template build after its gzipped context has been uploaded. Starting consumes that build record: it cannot be started twice, and a failed start may require creating and uploading a new build.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `secrets` | object | No | BuildKit RUN secrets keyed by secret ID. Values are sensitive request-body data used only for this build; omit when unnecessary. |
| `build_id` | string | Yes | Template build ID returned by CREATE_TEMPLATE_BUILD. |
| `registry_auth` | object | No | Private FROM-image logins keyed by registry host. Each value must contain exactly username and password keys; password may hold an access token. These are sensitive request-body data used only for this build. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Top Up Instance Budget

**Slug:** `AGENT37_TOP_UP_INSTANCE_BUDGET`

Irreversibly add one-time managed-service spending headroom to an instance. This moves no funds, but the added allowance persists across months and can authorize additional charges against the workspace wallet. Supply an idempotency key before retrying after a timeout to avoid adding the allowance twice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `instance_id` | string | Yes | Exact bare 10-character lowercase alphanumeric instance ID. |
| `amount_micros` | integer | Yes | Positive one-time managed-service headroom to add, in integer millionths of a US dollar. This is a spending ceiling, not a wallet transfer. |
| `idempotency_key` | string | No | Optional retry key of 1-64 ASCII letters, digits, underscores, or hyphens. Use a new key for each intended addition and reuse that key only to retry the same top-up; Agent37 then returns the current budget without adding the amount again. Without a key, retrying can add headroom more than once. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Cron

**Slug:** `AGENT37_UPDATE_CRON`

Change a recurring schedule's prompt, timing, agent, profile, name, timezone, or enabled state. Set enabled to false to pause future firings; enabling it resumes agent work, and each firing can wake the instance and incur compute or managed-service costs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Replacement human-readable schedule name. Omit to leave it unchanged; null is not accepted. |
| `agent` | string ("hermes" | "openclaw" | "claude-code" | "codex" | "opencode" | "grok" | "pi") | No | Replacement agent harness. Omit to leave it unchanged; use reset_agent to restore the instance template's agent. |
| `prompt` | string | No | Replacement agent message for future firings. Omit to leave it unchanged; null is not accepted. |
| `cron_id` | string | Yes | Twelve-character hexadecimal cron ID to update. |
| `enabled` | boolean | No | Set true to enable future firings or false to pause them. Omit to leave the state unchanged; null is not accepted. |
| `profile` | string | No | Replacement agent profile. Omit to leave it unchanged; use reset_profile to restore the agent's default profile. |
| `schedule` | string | No | Replacement five-field cron expression. Omit to leave it unchanged; null is not accepted. |
| `timezone` | string | No | Replacement IANA timezone. Omit to leave it unchanged; null is not accepted. |
| `instance_id` | string | Yes | Instance ID that owns the recurring schedule. |
| `reset_agent` | boolean | No | Set true to restore the instance template's default agent. Cannot be combined with agent. |
| `reset_profile` | boolean | No | Set true to restore the selected agent's default profile. Cannot be combined with profile. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Instance Image

**Slug:** `AGENT37_UPDATE_INSTANCE_IMAGE`

Apply a template image to an instance while preserving its mounted disk. This irreversibly discards changes outside the mount path and recreates a running instance's container; read its logs first when repairing a failure.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template` | string | No | Template name or version pin to apply. Omit it to re-resolve the instance's stored template. |
| `instance_id` | string | Yes | ID of the instance whose template image should be applied. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Instance Settings

**Slug:** `AGENT37_UPDATE_INSTANCE_SETTINGS`

Update an instance's name, metadata, environment, auto-sleep, idle timeout, or outbound network policy without changing its image or compute size.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `env` | object | No | Environment variable updates. A null property value unsets that variable; other stored variables remain unchanged. |
| `name` | string | No | New display name; null or an empty string clears the current name. |
| `network` | string | No | Replacement outbound network policy: allow all, deny all, or allow only listed destinations. |
| `metadata` | object | No | Replacement caller metadata; null or an empty object clears it. |
| `auto_sleep` | boolean | No | Enable or disable automatic sleep when the instance is idle. |
| `instance_id` | string | Yes | Instance ID to update. |
| `idle_timeout_seconds` | integer | No | Idle seconds before auto-sleep, from 300 through 86400. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Template

**Slug:** `AGENT37_UPDATE_TEMPLATE`

Update a workspace template's name, image, description, default port, or entrypoint. Image or entrypoint changes publish a new revision; existing instances do not change automatically.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Replacement template name. Omit to leave unchanged; null is not accepted. |
| `image_ref` | string | No | Replacement fully qualified linux/amd64 image reference. Omit to leave unchanged; null is not accepted. |
| `entrypoint` | array | No | Replacement non-empty command argument array. Send null to restore the image command; omit to leave unchanged. |
| `description` | string | No | Replacement free-text description. Omit to leave unchanged; null is not accepted. |
| `default_port` | integer | No | Replacement main service port. Send null to clear it to the 3737 fallback; omit to leave unchanged. |
| `registry_auth` | object | No | One-time private-registry login object with exactly username and password keys. Omit unless image_ref needs it; null and empty values are not accepted. |
| `template_name` | string | Yes | Current workspace template name to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Domain

**Slug:** `AGENT37_VERIFY_DOMAIN`

Check and nudge verification after replacing a registered dedicated domain's nameservers with those returned by REGISTER_DOMAIN. The paid custom-domain feature requires $50 in cumulative workspace top-ups before registration; verification is idempotent and may remain pending while full DNS delegation propagates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | Registered domain whose Agent37 nameserver delegation should be checked. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
