--- title: Render API Integration on Truto slug: render category: CI/CD canonical: "https://truto.one/integrations/detail/render/" --- # Render API Integration on Truto **Category:** CI/CD **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. - **Workspaces** — Workspaces represent concepts like teams, workspaces, projects in apps that support them ## MCP-ready AI tools Truto exposes 144 tools for Render that AI agents can call directly. - **list_all_render_workspaces** — List workspaces accessible by your API key in Render, filtered by name or owner email. Returns owner details including id, name, email, twoFactorAuthEnabled, and type, along with a cursor for pagination. - **get_single_render_workspace_by_id** — Get workspace by ownerId in Render. Provide ownerId which can be a workspace ID starting with 'tea-' or a user ID starting with 'own-'. Returns the workspace details or user's default workspace. - **list_all_render_me** — Get the authenticated user in Render. Returns email and name of the user associated with the provided API key. - **list_all_render_workspace_members** — List workspace members for the workspace with owner_id in Render. Returns userId, name, email, status, role, and mfaEnabled for each member. - **get_single_render_event_by_id** — Get details of a specific event in Render by id. Returns event id, timestamp, serviceId, type, and details describing the event configuration or status. - **list_all_render_webhooks** — List webhooks with optional ownerId filter in Render. Returns webhook objects including id, url, name, secret, enabled status, and eventFilter, along with a cursor for pagination. - **get_single_render_webhook_by_id** — Get webhook by id in Render. Returns id, url, name, secret, enabled status, and eventFilter which lists event types triggering the webhook. - **create_a_render_webhook** — Create a webhook in Render with enabled status. Returns id, url, name, secret, enabled, and eventFilter fields in the response. - **update_a_render_webhook_by_id** — Update a webhook by id in Render. Returns id, url, name, secret, enabled status, and eventFilter array indicating event types triggering the webhook. - **delete_a_render_webhook_by_id** — Delete a webhook by id in Render. Returns status 204 on success. Possible error responses include 401 for authorization issues, 404 if webhook not found, 429 for rate limit exceeded, 500 for server error, and 503 if server unavailable. Response errors include id and message fields. - **list_all_render_webhook_events** — List webhook events for webhook with id in Render. Returns webhookEvent objects including id, eventId, eventType, sentAt, statusCode, responseBody, and error fields. - **list_all_render_blueprints** — List blueprints filtered by ownerId in Render. Returns blueprint objects with id, name, status, autoSync, repo, branch, and lastSync fields. Requires ownerId if filtering by workspace. - **get_single_render_blueprint_by_id** — Retrieve blueprint by id in Render. Returns id, name, status, autoSync, repo, branch, lastSync, and resources with their id, name, and type. - **update_a_render_blueprint_by_id** — Update blueprint with id in Render. Returns id, name, status (created, paused, in_sync, syncing, error), autoSync, repo, branch, and lastSync fields in response. - **delete_a_render_blueprint_by_id** — Disconnect blueprint with id in Render. Stops automatic resource syncing via render.yaml but does not delete managed services or resources. Returns status 204 on success. - **list_all_render_blueprint_syncs** — List syncs for the blueprint with the provided id in Render. Returns sync objects including id, commit id, startedAt, completedAt, and state fields. - **list_all_render_custom_domains** — List custom domains for a service in Render using service_id. Returns fields id, name, domainType, publicSuffix, redirectForName, verificationStatus, createdAt, and server details. - **get_single_render_custom_domain_by_id** — Get a custom domain for a service in Render using service_id and id. Returns id, name, domainType, publicSuffix, redirectForName, verificationStatus, createdAt, and server details. - **create_a_render_custom_domain** — Add a custom domain to the service with service_id in Render. Returns id, name, domainType, publicSuffix, redirectForName, verificationStatus, createdAt, and server details. - **delete_a_render_custom_domain_by_id** — Delete a custom domain for a service in Render using service_id and id. Returns 204 on success with no content. - **list_all_render_services** — List services matching provided filters in Render. Returns service objects with fields including id, name, type, environmentId, ownerId, suspended status, createdAt, updatedAt, and serviceDetails such as buildCommand and url. - **get_single_render_service_by_id** — Retrieve service by id in Render. Returns id, name, type, ownerId, createdAt, updatedAt, dashboardUrl, autoDeploy, branch, buildFilter, environmentId, imagePath, notifyOnFail, registryCredential, rootDir, repo, slug, suspended, suspenders, and serviceDetails. - **create_a_render_service** — Create a service in Render with required parameters type, name, and ownerId. Returns service id, name, type, ownerId, createdAt, updatedAt, dashboardUrl, and other service details. - **update_a_render_service_by_id** — Update service configuration by service id in Render. Returns updated service fields including id, autoDeploy, branch, buildFilter, createdAt, dashboardUrl, environmentId, imagePath, name, notifyOnFail, ownerId, registryCredential, repo, rootDir, slug, suspended, suspenders, type, updatedAt, serviceDetails, env, envSpecificDetails, lastSuccessfulRunAt, plan, region, runtime, schedule, and buildPlan. - **delete_a_render_service_by_id** — Delete service by id in Render. Returns status 204 on success or error object with id and message on failure. - **list_all_render_deploys** — List deploys for a service in Render using service_id. Returns deploy id, commit details (id, message, createdAt), image info (ref, sha, registryCredential), status, trigger, and timestamps (startedAt, finishedAt, createdAt, updatedAt). - **get_single_render_deploy_by_id** — Retrieve details of a specific deploy for a service in Render using service_id and id. Returns deploy id, commit info (id, message, createdAt), image info (ref, sha, registryCredential), status, trigger, and timestamps (startedAt, finishedAt, createdAt, updatedAt). - **create_a_render_deploy** — Trigger a deploy for the service with id in Render. Returns deploy id, commit details (id, message, createdAt), image info (ref, sha, registryCredential), status, trigger, and timestamps (startedAt, finishedAt, createdAt, updatedAt). - **render_deploys_cancel** — Cancel an in-progress deploy for a service in Render. Requires service_id and id. Returns deploy id, commit details (id, message, createdAt), image info (ref, sha, registryCredential), status, trigger, and timestamps (startedAt, finishedAt, createdAt, updatedAt). Not supported for cron jobs. - **render_deploys_roll_back** — Trigger a rollback to a previous deploy of the specified service in Render using service_id and deployId. Returns deploy id, commit details, status, trigger, and timestamps. Autodeploys remain enabled after rollback. - **list_all_render_disks** — List persistent disks in Render filtered by ownerId, diskId, name, createdBefore, createdAfter, updatedBefore, updatedAfter, and serviceId. Returns disk id, name, sizeGB, mountPath, serviceId, createdAt, and updatedAt fields. - **get_single_render_disk_by_id** — Retrieve the persistent disk with the provided id in Render. Returns id, name, sizeGB, mountPath, serviceId, createdAt, and updatedAt fields. - **create_a_render_disk** — Add disk with name, sizeGB, mountPath, and serviceId in Render. Returns id, name, sizeGB, mountPath, serviceId, createdAt, and updatedAt. Service must be redeployed for disk attachment. - **update_a_render_disk_by_id** — Update the persistent disk with id in Render. Requires the disk's associated service to be deployed and active. The response returns id, name, sizeGB, mountPath, serviceId, createdAt, and updatedAt fields. - **delete_a_render_disk_by_id** — Delete a persistent disk by id in Render. All data on the disk will be lost and the associated service will lose access immediately. Returns status code 204 on success. - **list_all_render_disk_snapshots** — List snapshots for the persistent disk with the provided id in Render. Returns createdAt (snapshot creation time), snapshotKey (identifier), and instanceId (attached instance identifier). - **render_disk_snapshots_restore** — Restore a persistent disk to an available snapshot in Render using diskId and snapshotKey. This irreversible operation overwrites current disk data and may trigger a service deploy. Returns id, name, sizeGB, mountPath, serviceId, createdAt, and updatedAt. - **list_all_render_environment_groups** — List environment groups in Render. Returns id, name, ownerId, createdAt, updatedAt, serviceLinks (id, name, type), and environmentId for each environment group. - **get_single_render_environment_group_by_id** — Get environment group by id in Render. Returns id, name, ownerId, createdAt, updatedAt, serviceLinks (id, name, type), environmentId, envVars (key, value), and secretFiles (name, content). - **create_a_render_environment_group** — Create a new environment group in Render with required parameters name, ownerId, and envVars. Returns id, name, ownerId, createdAt, updatedAt, serviceLinks (id, name, type), environmentId, envVars (key, value), and secretFiles (name, content). - **update_a_render_environment_group_by_id** — Update environment group name by id in Render. Returns id, name, ownerId, createdAt, updatedAt, serviceLinks (id, name, type), environmentId, envVars (key, value), and secretFiles (name, content). - **delete_a_render_environment_group_by_id** — Delete environment group by id in Render, including all environment variables and secret files it contains. Returns status 204 on success. - **get_single_render_environment_variable_by_id** — Retrieve a particular environment variable in a specific environment group in Render. Requires env_group_id and env_var_key. Returns key and value of the environment variable. - **update_a_render_environment_variable_by_id** — Add or update an environment variable in a specific environment group in Render. Requires env_group_id and env_var_key. Returns id, name, ownerId, createdAt, updatedAt, serviceLinks (id, name, type), environmentId, envVars (key, value), and secretFiles (name, content). - **delete_a_render_environment_variable_by_id** — Remove a particular environment variable from a specific environment group in Render. Requires env_group_id and env_var_key. Returns 204 on success. - **get_single_render_secret_file_by_id** — Retrieve a particular secret file by envGroupId and secretFileName in Render. Returns name and content of the secret file. - **update_a_render_secret_file_by_id** — Add or update a secret file in Render by envGroupId and secretFileName. Returns id, name, ownerId, createdAt, updatedAt, serviceLinks (id, name, type), environmentId, envVars (key, value), and secretFiles (name, content). - **delete_a_render_secret_file_by_id** — Remove a secret file from an environment group in Render. Requires envGroupId and id. Returns 204 on success with no content. - **list_all_render_logs** — List logs for ownerId with filters resource, startTime, and endTime in Render. Returns hasMore, nextStartTime, nextEndTime for pagination and logs with id, message, timestamp, and labels. - **list_all_render_subscribe_logs** — Subscribe to new logs for ownerId filtered by resource. Returns real-time log entries with id, message, timestamp, and labels including resource, instance, host, statusCode, method, level, type, text, and path. - **list_all_render_log_label_values** — List all values for a given log label in Render logs filtered by ownerId and label. Returns an array of strings representing possible values for the specified log label. - **get_single_render_log_stream_by_id** — Get log stream information for the specified workspace in Render. Requires owner_id. Returns ownerId, endpoint for streaming logs, and preview status indicating whether logs are sent or dropped. - **update_a_render_log_stream_by_id** — Update log stream information for the workspace with owner_id in Render. Returns ownerId, endpoint, and preview fields indicating the updated log stream settings. - **delete_a_render_log_stream_by_id** — Delete the log stream for the workspace identified by owner_id in Render. Returns status 204 on success with no content. - **list_all_render_log_stream_overrides** — List log stream overrides filtered by ownerId, logStreamId, resourceId, and setting in Render. Returns resourceId, endpoint, and setting fields for each override. - **get_single_render_log_stream_override_by_id** — Get log stream override information for the specified resource in Render. Requires resource_id. Returns resourceId, endpoint (log stream destination), and setting (send or drop). - **update_a_render_log_stream_override_by_id** — Update log stream override for resource id in Render. Returns resourceId, endpoint, and setting indicating whether logs are sent or dropped. - **delete_a_render_log_stream_override_by_id** — Delete log stream override for the resource with id in Render. Returns status 204 on success, or error object with id and message on failure. - **list_all_render_maintenance_runs** — List scheduled and recent maintenance runs filtered by resourceId, ownerId, and state in Render. Returns id, type, scheduledAt, pendingMaintenanceBy, state, and resourceId for each maintenance run. - **get_single_render_maintenance_run_by_id** — Get maintenance run by id in Render. Returns id, type, scheduledAt, pendingMaintenanceBy, state, and resourceId fields describing the maintenance run details. - **update_a_render_maintenance_run_by_id** — Update maintenance run with id in Render. Requires scheduledAt date-time before pendingMaintenanceBy. Response includes id and message indicating update status. - **render_maintenance_runs_trigger** — Trigger the scheduled maintenance run with the provided id in Render. The response includes id and message fields indicating the trigger status. Maintenance state changes can be tracked via the Retrieve maintenance run endpoint. - **get_single_render_metrices_stream_by_id** — Get metrics stream information for the workspace specified by id in Render. Returns ownerId, provider (BETTER_STACK, GRAFANA, DATADOG, NEW_RELIC, HONEYCOMB, CUSTOM), and the streaming endpoint URL. - **delete_a_render_metrices_stream_by_id** — Delete metrics stream for workspace with owner_id in Render. Returns 204 on success, or error message with id and message fields on failure. - **update_a_render_metrices_stream_by_id** — Create or update the metrics stream for the workspace with ownerId in Render. Returns ownerId, provider, and url of the updated metrics stream. - **list_all_render_cpu_usage** — Get CPU usage for one or more resources in Render. Requires resource IDs or instance IDs as query parameters. Returns labels describing the time series, values with timestamps and CPU usage values, and the unit of measurement. - **list_all_render_cpu_limit** — Get CPU limit for resources with parameters startTime, endTime, resolutionSeconds, resource, and instance. Returns labels describing the time series, values with timestamp and value, and unit. - **list_all_render_cpu_target** — Get CPU target for one or more resources in Render. Requires resource or instance parameters. Returns labels describing the time series, values with timestamp and value, and unit of measurement. - **list_all_render_memory_usage** — Get memory usage for one or more resources in Render. Requires startTime, endTime, resolutionSeconds, resource, and instance as query parameters. Returns labels describing the time series, values with timestamp and value, and unit in the response. - **list_all_render_memory_limit** — Get memory limit for one or more resources in Render. Requires resource or instance query parameters. Returns labels describing the time series, values with timestamp and value, and unit of measurement. - **list_all_render_memory_target** — Get memory target for one or more resources in Render. Requires resource or instance parameters. Returns labels describing the time series, values with timestamp and value, and unit of measurement. - **list_all_render_http_request_count** — Get HTTP request count filtered by startTime, endTime, resolutionSeconds, resource, host, path, and aggregateBy in Render. Returns labels describing the time series, values with timestamp and count, and unit. - **list_all_render_http_latency** — Get HTTP latency metrics for one or more resources in Render. Requires startTime, endTime, resolutionSeconds, resource, host, path, and quantile as query parameters. Returns labels describing the time series, values with timestamp and latency value, and unit of measurement. - **list_all_render_bandwidth_usage** — Get bandwidth usage for one or more resources in Render. Requires startTime and endTime to specify the time range, and resource to specify the service ID(s). Returns labels describing the time series, values with timestamps and usage, and unit of measurement. - **list_all_render_disk_usage** — Get persistent disk usage for one or more resources in Render. Requires resource IDs as query parameters. Returns labels describing the time series, values with timestamp and usage, and unit of measurement. - **list_all_render_disk_capacity** — Get persistent disk capacity for one or more resources in Render. Requires resource. Returns labels describing the time series, values with timestamp and value, and unit of measurement. - **list_all_render_instance_count** — Get the instance count for one or more resources in Render. Requires startTime, endTime, resolutionSeconds, and resource parameters. Returns labels describing the time series, values with timestamp and count, and unit of measurement. - **list_all_render_active_connection_count** — Get the number of active connections for one or more Postgres databases or Redis instances in Render. Requires resource. Returns labels describing the time series, values with timestamp and connection count, and unit. - **list_all_render_replica_lag** — Get seconds of replica lag of a Postgres replica in Render. Requires resource (Postgres ID) parameter. Returns labels describing the time series, values with timestamp and lag value, and unit of measurement. - **list_all_render_queryable_instance_values** — List queryable instance values to filter by for one or more resources in Render. Requires startTime, endTime, resolutionSeconds, and resource parameters. Returns filter and values fields in the response. - **list_all_render_queryable_path** — List queryable paths filtered by startTime, endTime, resolutionSeconds, resource, host, statusCode, and path in Render. Returns an array of path strings based on recent log lines. - **list_all_render_notification_settings** — Get notification settings for the owner with owner_id in Render. Returns ownerId, slackEnabled, emailEnabled, previewNotificationsEnabled, and notificationsToSend fields. - **update_a_render_notification_setting_by_id** — Update notification settings for the owner with id in Render. Returns ownerId, slackEnabled, emailEnabled, previewNotificationsEnabled, and notificationsToSend fields in the response. - **list_all_render_notification_overrides** — List notification overrides filtered by ownerId and serviceId in Render. Returns override objects with serviceId, previewNotificationsEnabled, notificationsToSend, and cursor for pagination. - **get_single_render_notification_override_by_id** — Retrieve the notification override for the service with the provided id in Render. Returns serviceId, previewNotificationsEnabled (default, false, true), and notificationsToSend (default, none, failure, all). - **update_a_render_notification_override_by_id** — Update notification override for the service with id in Render. Returns serviceId, previewNotificationsEnabled (default, false, true), and notificationsToSend (default, none, failure, all). - **list_all_render_jobs** — List jobs for the provided service using service_id in Render. Returns job fields including id, serviceId, startCommand, planId, status, createdAt, startedAt, and finishedAt. - **get_single_render_job_by_id** — Retrieve details of a specific job for a service in Render using service_id and id. Returns id, serviceId, startCommand, planId, status, createdAt, startedAt, and finishedAt fields. - **create_a_render_job** — Create a one-off job for a service in Render using service_id. Returns id, serviceId, startCommand, planId, status, createdAt, startedAt, and finishedAt fields in the response. - **render_jobs_cancel** — Cancel a particular one-off job for a particular service in Render. Requires service_id and id. Returns id, serviceId, startCommand, planId, status, createdAt, startedAt, and finishedAt fields. - **list_all_render_postgres_instances** — List Postgres instances in Render filtered by name, region, suspended status, createdBefore, createdAfter, updatedBefore, updatedAfter, ownerId, environmentId, and includeReplicas. Returns id, name, status, region, owner, plan, version, suspended, and dashboardUrl fields. - **get_single_render_postgres_instance_by_id** — Retrieve a Postgres instance by id in Render. Returns id, name, region, version, state, plan, diskSizeGB, highAvailabilityEnabled, environmentId, databaseName, databaseUser, dashboardUrl, ipAllowList with cidrBlock and description, maintenance details, owner info including id, name, email, twoFactorAuthEnabled, readReplicas with id, name, role, status, and suspenders. - **create_a_render_postgres_instance** — Create a new Postgres instance in Render with required parameters ownerId, name, plan, and version. Returns id, ipAllowList with cidrBlock and description, createdAt, updatedAt, expiresAt, dashboardUrl, databaseName, databaseUser, environmentId, highAvailabilityEnabled, maintenance details, name, owner info, plan, diskSizeGB, primaryPostgresID, region, readReplicas, version, suspended status, and suspenders. - **update_a_render_postgres_instance_by_id** — Update a Postgres instance by id in Render. Returns updated instance fields including id, ipAllowList with cidrBlock and description, createdAt, updatedAt, expiresAt, dashboardUrl, databaseName, databaseUser, environmentId, highAvailabilityEnabled, maintenance details, name, owner info, plan, diskSizeGB, primaryPostgresID, region, readReplicas, role, status, version, suspended, and suspenders. - **delete_a_render_postgres_instance_by_id** — Delete a Postgres instance by id in Render. This operation is irreversible and all data will be lost. Returns status code indicating success or error with id and message fields. - **get_single_render_postgres_connection_info_by_id** — Retrieve connection info for a Postgres instance by id in Render. Returns password, internalConnectionString, externalConnectionString, and psqlCommand. - **list_all_render_postgres_exports** — List exports for a Postgres instance by id in Render. Returns an array of exports with fields id, createdAt (export creation time), and url (download link). - **create_a_render_postgres_export** — Create an export of a Postgres instance by id in Render. Returns id and message confirming export start or error details. - **list_all_render_projects** — List projects filtered by name, createdBefore, createdAfter, updatedBefore, updatedAfter, and ownerId in Render. Returns project id, createdAt, updatedAt, name, owner details, and environmentIds. - **get_single_render_project_by_id** — Get project by id in Render. Returns id, createdAt, updatedAt, name, owner (id, name, email, twoFactorAuthEnabled, type), and environmentIds. - **create_a_render_project** — Create a new project in Render with required parameters name, ownerId, and environments. Returns project id, createdAt, updatedAt, name, owner details (id, name, email, twoFactorAuthEnabled, type), and environmentIds. - **update_a_render_project_by_id** — Update project details by id in Render. Returns id, createdAt, updatedAt, name, owner (id, name, email, twoFactorAuthEnabled, type), and environmentIds. - **delete_a_render_project_by_id** — Delete project by id in Render. This operation is irreversible and deletes all environments and services in the project. Returns status 204 on success. - **list_all_render_environments** — List environments filtered by projectId in Render. Returns environment details including id, name, projectId, associated database, redis, service, envGroup IDs, protectedStatus, and networkIsolationEnabled fields. - **get_single_render_environment_by_id** — Retrieve environment by id in Render. Returns id, name, projectId, databasesIds, redisIds, serviceIds, envGroupIds, protectedStatus indicating if environment is protected, and networkIsolationEnabled indicating network connection status. - **update_a_render_environment_by_id** — Update environment details by id in Render. Returns id, name, projectId, databasesIds, redisIds, serviceIds, envGroupIds, protectedStatus, and networkIsolationEnabled fields in the response. - **delete_a_render_environment_by_id** — Delete environment by id in Render. This operation is irreversible and deletes all services and resources belonging to the environment. Returns status code 204 on success. - **create_a_render_environment_resource** — Add resources to the environment with the provided id in Render. Returns id, name, projectId, databasesIds, redisIds, serviceIds, envGroupIds, protectedStatus indicating protection level, and networkIsolationEnabled indicating network connection status. - **delete_a_render_environment_resource_by_id** — Remove resources from the environment with the provided environmentId and resourceIds. Returns 204 on success with no content. - **list_all_render_key_value_instances** — List Key Value instances filtered by environmentId in Render. Returns fields including id, createdAt, updatedAt, status, region, plan, name, owner details, options, ipAllowList, environmentId, version, and dashboardUrl. - **get_single_render_key_value_instance_by_id** — Get a Key Value instance by id in Render. - **create_a_render_key_value_instance** — Create a new Key Value instance in Render with required parameters name, ownerId, and plan. Returns id, createdAt, updatedAt, status, region, plan, name, owner details, options, environmentId, version, and maintenance information. - **update_a_render_key_value_instance_by_id** — Update Key Value instance by id in Render. Returns id, createdAt, updatedAt, status, region, plan, name, owner details, options including maxmemoryPolicy and ipAllowList, environmentId, version, and maintenance info. - **delete_a_render_key_value_instance_by_id** — Delete Key Value instance by id in Render. Returns 204 on success or error object with id and message on failure. - **list_all_render_redis_instance** — List Redis instances in Render filtered by name, region, createdBefore, createdAfter, updatedBefore, updatedAfter, ownerId, and environmentId. Returns Redis instance objects matching filters. - **get_single_render_redis_instance_by_id** — Retrieve a Redis instance by id in Render. Returns id, createdAt, updatedAt, status, region, plan, name, owner details, options, environmentId, version, and maintenance information. - **create_a_render_redis_instance** — Create a new Redis instance in Render with required parameters name, ownerId, and plan. Returns id, createdAt, updatedAt, status, region, plan, name, owner details, options, version, and maintenance information. - **update_a_render_redis_instance_by_id** — Update a Redis instance by id in Render. Returns id, createdAt, updatedAt, status, region, plan, name, owner details, options, environmentId, version, and maintenance information. - **delete_a_render_redis_instance_by_id** — Delete Redis instance by id in Render. Returns 204 on success or error object with id and message on failure. - **list_all_render_registry_credentials** — List registry credentials in Render matching the provided filters. Returns id, name, registry, username, and updatedAt fields for each credential. - **get_single_render_registry_credential_by_id** — Retrieve registry credential by id in Render. Returns id, name, registry, username, and updatedAt fields. - **create_a_render_registry_credential** — Create a new registry credential in Render with required parameters registry, name, username, authToken, and ownerId. Returns id, name, registry, username, and updatedAt fields in the response. - **update_a_render_registry_credential_by_id** — Update registry credential by id in Render. Returns id, name, registry, username, and updatedAt fields. Services using this credential must be redeployed to apply changes. - **delete_a_render_registry_credential_by_id** — Delete registry credential with id in Render. Returns status 204 on success. - **list_all_render_service_environment_variables** — List all environment variables for the service with id in Render. Returns envVar objects containing key and value fields. Note: only variables directly belonging to the service are returned, not those from linked environment groups. - **get_single_render_service_environment_variable_by_id** — Retrieve a particular environment variable for a service in Render using service_id and env_var_key. Returns key and value of the environment variable. - **create_a_render_service_environment_variable** — Add or update an environment variable for a service in Render using service_id and env_var_key. Returns key and value of the environment variable. - **update_a_render_service_environment_variable_by_id** — Replace all environment variables for a service in Render using serviceId. Returns an array of updated environment variable objects with key and value fields, and a cursor string. - **delete_a_render_service_environment_variable_by_id** — Delete environment variable env_var_key from service with service_id in Render. Only applies to variables set directly on the service. Returns 204 on success. - **list_all_render_environment_secret_files** — List all secret files for the service with the provided service_id in Render. Returns secretFile objects including name and content, and a cursor for pagination. - **get_single_render_environment_secret_file_by_id** — Retrieve a particular secret file for a service in Render using service_id and secret_file_name. Returns name and content of the secret file. - **create_a_render_environment_secret_file** — Add or update a secret file for a service in Render using service_id and secretFileName. Returns the name and content of the secret file. - **update_a_render_environment_secret_file_by_id** — Replace all secret files for a service in Render using serviceId. Returns updated secretFile objects with name and content, and a cursor string. Existing secret files not included will be deleted. - **delete_a_render_environment_secret_file_by_id** — Delete a secret file from a service in Render using service_id and secret_file_name. Returns status 204 on success. - **create_a_render_cron_job** — Trigger a run for a cron job with id in Render. Returns id, status, startedAt, finishedAt, triggeredBy, and canceledBy fields in the response. - **delete_a_render_cron_job_by_id** — Cancel a currently running cron job in Render using id. Returns status code 204 on successful cancellation. - **list_all_render_header_rules** — List response header rules for a specific service in Render using serviceId. Returns header id, path, name, and value fields for each rule. - **create_a_render_header_rule** — Add a response header rule to the service with the provided service_id in Render. Returns the header rule's id, path, name, and value. - **update_a_render_header_rule_by_id** — Replace all header rules for a service in Render using serviceId. Returns an array of header rules with id, path, name, and value fields. This operation deletes all existing header rules not included in the request. - **delete_a_render_header_rule_by_id** — Delete a particular response header rule for a service in Render. Requires service_id and id. Returns 204 on success with no content. - **list_all_render_redirect_rewrite_rules** — List redirect/rewrite rules for a service in Render using serviceId. Returns route objects with id, type, source, destination, and priority fields. - **create_a_render_redirect_rewrite_rule** — Add redirect/rewrite rules to the service with the provided service_id in Render. Returns id, type, source, destination, and priority of the created rule. Priority determines rule application order starting at 0. - **update_a_render_redirect_rewrite_rule_by_id** — Replace all redirect/rewrite rules for a service in Render using serviceId. Returns updated rules with id, type, source, destination, and priority fields. This deletes all existing rules not included in the request. - **delete_a_render_redirect_rewrite_rule_by_id** — Delete a redirect/rewrite rule for a service in Render using service_id and id. Returns status 204 on success or error details with id and message on failure. ## How it works 1. **Link your customer's Render account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Render.** The Proxy API is a 1-to-1 mapping of the Render API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Trigger deployments from your product when content or config changes** — If you run a headless CMS, website builder, or feature flag platform, you can trigger Render deploys automatically when your users publish content or toggle settings — without them ever leaving your product. - **Sync secrets and environment variables from a centralized vault** — Security and secrets management SaaS products can push rotated credentials directly into Render environment groups and service-level environment variables, ensuring your customers' infrastructure stays in sync without manual copy-paste. - **Surface deployment history and service health in an internal developer portal** — Developer platform and engineering productivity tools can pull services, deploys, and performance metrics from Render to give engineering teams a unified view of their infrastructure without context-switching into the Render dashboard. - **Automate incident response with one-click rollbacks** — Incident management and observability SaaS products can correlate latency spikes or errors with specific Render deploys and offer automated or one-click rollback capabilities directly from their alerting UI. - **Provision infrastructure programmatically for multi-tenant platforms** — SaaS platforms that spin up isolated environments per customer can use Render's API to create services, databases, custom domains, and environment variables as part of an automated tenant onboarding flow. ## What you can build - **Automated deploy-on-publish pipeline** — Trigger a Render deploy via create_a_render_deploy whenever a user publishes content, merges a config change, or rotates a secret in your product. - **Custom domain provisioning for white-label customers** — Programmatically map customer-owned domains to Render services using create_a_render_custom_domain when users upgrade plans or configure vanity URLs. - **Environment variable and secret sync engine** — Keep Render environment groups and service-level variables in sync with your vault by writing to create, update, and delete environment variable and secret file endpoints. - **Deploy history and DORA metrics dashboard** — Pull deployment records via list_all_render_deploys and webhook events to calculate deploy frequency, failure rate, and lead time directly inside your analytics product. - **Infrastructure health monitoring panel** — Aggregate CPU usage, memory usage, HTTP latency, and bandwidth metrics from Render's metrics endpoints to display real-time service health alongside your own observability data. - **One-click rollback from incident alerts** — Embed a rollback action in your incident management workflow that calls render_deploys_roll_back to revert a problematic deploy without leaving your alerting tool. ## FAQs ### What authentication method does the Render integration use? ### Which Render resources can I read and write through Truto? You get full CRUD support across services, deploys, custom domains, environment variables, secret files, environment groups, PostgreSQL instances, Redis/Key-Value instances, webhooks, blueprints, projects, disks, log streams, notification settings, registry credentials, header rules, redirect/rewrite rules, cron jobs, and jobs. You can also read metrics like CPU, memory, HTTP latency, bandwidth, disk usage, and replica lag. ### Does Truto handle pagination for Render API list endpoints? Yes. Truto abstracts away cursor-based pagination on all list endpoints such as list_all_render_services, list_all_render_deploys, and list_all_render_logs, so you receive complete result sets without managing pagination tokens yourself. ### Can I map Render workspace members to a unified user directory? Yes. Render is mapped to Truto's Unified User Directory API, which provides normalized access to Roles, Users, and Workspaces across integrations. You can list workspace members and their roles through a consistent schema. ### Can I listen to Render events in real time? You can create and manage Render webhooks via create_a_render_webhook and list webhook events with list_all_render_webhook_events. This lets you subscribe to deploy status changes, service updates, and other platform events programmatically. ### How do I trigger a deploy and then roll back if something goes wrong? Use create_a_render_deploy to initiate a build for a specific service. Monitor its status with get_single_render_deploy_by_id or webhook events. If the deploy causes issues, call render_deploys_roll_back to revert to the previous stable version.