> This page is for Workforce.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Render

**Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Available Tools

#### list_deploys

List deploys for a Render service, ordered newest first. Returns deploy IDs, statuses, triggers, and timestamps. Use cur...

#### get_deploy

Get a single deploy by ID for a Render service. Returns status, trigger, commit, image, and timestamps. Use list_deploys...

#### trigger_deploy

Trigger a new deploy for a Render service. Optionally specify a commit SHA, Docker image URL, or whether to clear the bu...

#### cancel_deploy

Cancel an in-progress deploy for a Render service. Only deploys that are currently building or pending can be canceled....

#### rollback_deploy

Roll back a Render service to a previous deploy. The specified deploy must have previously reached 'live' status. Use li...

#### list_disks

List persistent disks with optional filters by serviceId or ownerId. Supports cursor pagination; pass cursor from page_i...

#### get_disk

Retrieve a single persistent disk by ID. Use list_disks to find valid IDs.

#### create_disk

Create a persistent disk and attach it to a service. Requires name, sizeGB, serviceId, and mountPath. Use list_disks to...

#### update_disk

Update a persistent disk's name or size. Disk size can only be increased, not decreased. Use list_disks to find valid ID...

#### delete_disk

Permanently delete a persistent disk. This cannot be undone and will detach the disk from its service. Use list_disks to...

#### list_custom_domains

List custom domains attached to a Render service. Returns domain IDs, names, verification status, and DNS configuration....

#### get_custom_domain

Retrieve a single custom domain by ID. Returns domain name, type, verification status, and server configuration. Use lis...

#### create_custom_domain

Add a custom domain to a Render service. Provide the fully qualified domain name (e.g. 'app.example.com'). After creatin...

#### delete_custom_domain

Remove a custom domain from a Render service. This cannot be undone. Use list_custom_domains to find valid domain IDs.

#### verify_custom_domain

Trigger DNS verification for a custom domain. Call this after configuring DNS records to confirm ownership. Use list_cus...

#### list_env_groups

List environment groups in your Render account with optional filters by name or ownerId. Supports cursor pagination. Use...

#### get_env_group

Retrieve a single environment group by ID, including its environment variables, secret files, and linked services. Use l...

#### create_env_group

Create a new environment group. Provide a name and ownerId (required). Optionally include initial envVars, secretFiles,...

#### update_env_group

Update an environment group's name. Use list_env_groups to find valid group IDs. To update env vars or secret files, use...

#### delete_env_group

Permanently delete an environment group. This cannot be undone. Linked services will lose access to the group's variable...

#### link_env_group_service

Link a service to an environment group so it can consume the group's variables. Use list_env_groups to find group IDs an...

#### unlink_env_group_service

Unlink a service from an environment group. The service will lose access to the group's variables. Use get_env_group to...

#### list_env_vars

List all environment variables for a Render service. Returns key/value pairs with pagination. Use list_services to find...

#### get_env_var

Get a single environment variable by key for a Render service. Use list_env_vars to find valid keys.

#### update_env_var

Add or update a single environment variable on a Render service. Creates the variable if it does not exist. Use list_ser...

#### delete_env_var

Delete an environment variable from a Render service by key. Use list_env_vars to find valid keys.

#### replace_env_vars

Replace ALL environment variables on a Render service with the provided list. WARNING: removes any existing variables no...

#### list_secret_files

List all secret files for a Render service. Returns file names and content with pagination. Use list_services to find va...

#### get_secret_file

Get a single secret file by name for a Render service. Use list_secret_files to find valid names.

#### update_secret_file

Update the content of a secret file on a Render service. Use list_secret_files to find valid names.

#### delete_secret_file

Delete a secret file from a Render service by name. Use list_secret_files to find valid names.

#### replace_secret_files

Replace ALL secret files on a Render service with the provided list. WARNING: removes any existing files not included in...

#### list_jobs

List one-off jobs for a Render service. Returns job IDs, statuses, start commands, and timestamps. Use cursor from page\_...

#### get_job

Get a single one-off job by ID for a Render service. Returns status, start command, plan, and timestamps. Use list_jobs...

#### create_job

Create and run a one-off job on a Render service. Provide the command to run; optionally specify a plan ID for compute r...

#### cancel_job

Cancel a running one-off job for a Render service. Only jobs in a running or pending state can be canceled. Use list_job...

#### trigger_cron_job

Manually trigger a cron job to run immediately outside its schedule. Use list_services to find valid cron job service ID...

#### cancel_cron_job

Cancel a currently running cron job execution. Only cron jobs that are actively running can be canceled. Use list_servic...

#### list_key_value

List all Key-Value (Redis-compatible) instances. Filter by name or ownerId. Returns IDs, names, plans, regions, and stat...

#### get_key_value

Retrieve a single Key-Value instance by ID. Returns plan, region, status, maxmemory policy, and IP allow-list. Use list\_...

#### create_key_value

Create a new Key-Value (Redis-compatible) instance. Requires name, ownerId, and plan. Optionally set region, maxmemory p...

#### update_key_value

Update a Key-Value instance. Modify name, plan, maxmemory policy, or IP allow-list. Use list_key_value to find valid IDs...

#### delete_key_value

Permanently delete a Key-Value instance. This cannot be undone. Use list_key_value to find valid IDs.

#### suspend_key_value

Suspend a Key-Value instance, stopping it and halting billing. Use list_key_value to find valid IDs.

#### resume_key_value

Resume a previously suspended Key-Value instance. Use list_key_value to find valid IDs.

#### get_key_value_connection_info

Retrieve connection details for a Key-Value instance, including internal/external connection strings and host/port. Use...

#### list_owners

List all Render workspace owners (teams and users). Supports cursor pagination and optional filtering by name or email.

#### get_owner

Retrieve a single Render workspace owner by ID. Use list_owners to find valid owner IDs.

#### list_owner_members

List members of a Render workspace/owner. Supports cursor pagination. Use list_owners to find valid owner IDs.

#### list_postgres

List all managed PostgreSQL databases. Filter by name, owner IDs, or include replicas. Use cursor from page_info to pagi...

#### get_postgres

Get details of a managed PostgreSQL database by ID, including plan, region, status, version, and connection info. Use li...

#### create_postgres

Create a new managed PostgreSQL database. Requires name, ownerId, and plan. Optionally set region, version, disk size, h...

#### update_postgres

Update a managed PostgreSQL database's name, plan, or IP allow-list. Use list_postgres to find valid IDs.

#### delete_postgres

Permanently delete a managed PostgreSQL database. This cannot be undone. Use list_postgres to find valid IDs.

#### restart_postgres

Restart a managed PostgreSQL database. This causes a brief interruption. Use list_postgres to find valid IDs.

#### suspend_postgres

Suspend a managed PostgreSQL database, stopping compute while retaining data. Use list_postgres to find valid IDs.

#### resume_postgres

Resume a suspended managed PostgreSQL database. Use list_postgres to find valid IDs.

#### get_postgres_connection_info

Get connection strings for a managed PostgreSQL database, including external and internal connection strings and psql co...

#### create_postgres_user

Create a new user in a managed PostgreSQL database. Use list_postgres to find valid database IDs.

#### list_postgres_users

List all users in a managed PostgreSQL database. Use cursor from page_info to paginate. Use list_postgres to find valid...

#### delete_postgres_user

Delete a user from a managed PostgreSQL database. Use list_postgres_users to find valid usernames. Use list_postgres to...

#### list_projects

List Render projects with optional filters by name or ownerId. Returns paginated results. Use cursor from page_info to f...

#### get_project

Retrieve a single Render project by ID. Use list_projects to find valid project IDs.

#### create_project

Create a new Render project. Requires a name and an ownerId (team or user). A project must have at least one environment...

#### update_project

Update a Render project's name. Use list_projects to find valid project IDs.

#### delete_project

Permanently delete a Render project. This cannot be undone. Use list_projects to find valid project IDs.

#### list_environments

List environments within a Render project. Returns paginated results. Use list_projects to find valid project IDs. Use c...

#### get_environment

Retrieve a single environment by environment ID. Use list_environments to find valid environment IDs.

#### create_environment

Create a new environment in a Render project. Requires a project ID and environment name. Use list_projects to find vali...

#### update_environment

Update an environment's name or protected status. Use list_projects and list_environments to find valid IDs.

#### delete_environment

Permanently delete an environment from a Render project. This cannot be undone. Use list_projects and list_environments...

#### add_environment_resources

Add one or more resources to a Render environment by resource IDs. Use list_environments to find valid environment IDs.

#### remove_environment_resources

Remove one or more resources from a Render environment by resource IDs. Use list_environments to find valid environment...

#### list_services

List Render services with optional filters: name, type, env, region, suspended, ownerId. Supports cursor pagination. Use...

#### get_service

Retrieve full details for a single Render service by ID. Use list_services to find valid service IDs.

#### create_service

Create a new Render service. Required: type (static_site, web_service, private_service, background_worker, cron_job), na...

#### update_service

Update a Render service's name, branch, autoDeploy setting, or serviceDetails. Use list_services to find valid service I...

#### delete_service

Permanently delete a Render service and all its associated resources. This cannot be undone. Use list_services to find v...

#### restart_service

Restart a running Render service. Use list_services to find valid service IDs.

#### suspend_service

Suspend a Render service, stopping all running instances. Use resume_service to bring it back. Use list_services to find...

#### resume_service

Resume a suspended Render service. Use list_services to find valid service IDs.

#### scale_service

Scale a Render service to the specified number of instances. Requires a paid plan. Use list_services to find valid servi...

#### purge_service_cache

Purge the build cache for a Render service. The next deploy will rebuild from scratch. Use list_services to find valid s...

#### list_service_instances

List running instances for a Render service. Supports cursor pagination. Use list_services to find valid service IDs.

#### list_service_events

List events for a Render service (deploys, restarts, suspensions, etc.). Supports cursor pagination. Use list_services t...

#### list_webhooks

List Render webhooks with optional owner filter. Supports cursor pagination. Use get_webhook to fetch full details for a...

#### get_webhook

Retrieve full details for a single Render webhook by ID. Use list_webhooks to find valid webhook IDs.

#### create_webhook

Create a new Render webhook. Required: name, url, ownerId. Optionally specify enabled and eventFilter (list of event typ...

#### update_webhook

Update a Render webhook's name, url, enabled state, or eventFilter. Use list_webhooks to find valid webhook IDs.

#### delete_webhook

Permanently delete a Render webhook by ID. Use list_webhooks to find valid webhook IDs.

#### list_webhook_events

List events delivered to a Render webhook. Supports cursor pagination. Use list_webhooks to find valid webhook IDs.