Render Public API

Render Public API

API version: 1.0.0

Auth

Bearer bearer

Base URL

https://api.render.com/v1

Setup

1. Set Authorization header with your Bearer token
2. GET /blueprints -- verify access
3. POST /blueprints/validate -- create first validate

Endpoints

196 endpoints across 25 groups. See references/api-spec.lap for full details.

blueprints

owners

disks

users

organizations

notification-settings

registrycredentials

services

cron-jobs

events

logs

metrics-stream

metrics

key-value

redis

postgres

projects

environments

env-groups

maintenance

webhooks

workflows

workflowversions

tasks

task-runs

Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:

• "List all blueprints?" -> GET /blueprints
• "Create a validate?" -> POST /blueprints/validate
• "Partially update a member?" -> PATCH /owners/{ownerId}/members/{userId}
• "Delete a member?" -> DELETE /owners/{ownerId}/members/{userId}
• "Get blueprint details?" -> GET /blueprints/{blueprintId}
• "Partially update a blueprint?" -> PATCH /blueprints/{blueprintId}
• "Delete a blueprint?" -> DELETE /blueprints/{blueprintId}
• "List all syncs?" -> GET /blueprints/{blueprintId}/syncs
• "List all disks?" -> GET /disks
• "Create a disk?" -> POST /disks
• "Get disk details?" -> GET /disks/{diskId}
• "Partially update a disk?" -> PATCH /disks/{diskId}
• "Delete a disk?" -> DELETE /disks/{diskId}
• "List all snapshots?" -> GET /disks/{diskId}/snapshots
• "Create a restore?" -> POST /disks/{diskId}/snapshots/restore
• "List all users?" -> GET /users
• "List all owners?" -> GET /owners
• "Get owner details?" -> GET /owners/{ownerId}
• "List all members?" -> GET /owners/{ownerId}/members
• "List all audit-logs?" -> GET /owners/{ownerId}/audit-logs
• "List all audit-logs?" -> GET /organizations/{orgId}/audit-logs
• "Get owner details?" -> GET /notification-settings/owners/{ownerId}
• "Partially update a owner?" -> PATCH /notification-settings/owners/{ownerId}
• "List all overrides?" -> GET /notification-settings/overrides
• "Get service details?" -> GET /notification-settings/overrides/services/{serviceId}
• "Partially update a service?" -> PATCH /notification-settings/overrides/services/{serviceId}
• "List all registrycredentials?" -> GET /registrycredentials
• "Create a registrycredential?" -> POST /registrycredentials
• "Get registrycredential details?" -> GET /registrycredentials/{registryCredentialId}
• "Partially update a registrycredential?" -> PATCH /registrycredentials/{registryCredentialId}
• "Delete a registrycredential?" -> DELETE /registrycredentials/{registryCredentialId}
• "List all services?" -> GET /services
• "Create a service?" -> POST /services
• "Get service details?" -> GET /services/{serviceId}
• "Partially update a service?" -> PATCH /services/{serviceId}
• "Delete a service?" -> DELETE /services/{serviceId}
• "Create a purge?" -> POST /services/{serviceId}/cache/purge
• "List all deploys?" -> GET /services/{serviceId}/deploys
• "Create a deploy?" -> POST /services/{serviceId}/deploys
• "Get deploy details?" -> GET /services/{serviceId}/deploys/{deployId}
• "Create a cancel?" -> POST /services/{serviceId}/deploys/{deployId}/cancel
• "Create a rollback?" -> POST /services/{serviceId}/rollback
• "List all env-vars?" -> GET /services/{serviceId}/env-vars
• "Get env-var details?" -> GET /services/{serviceId}/env-vars/{envVarKey}
• "Update a env-var?" -> PUT /services/{serviceId}/env-vars/{envVarKey}
• "Delete a env-var?" -> DELETE /services/{serviceId}/env-vars/{envVarKey}
• "List all secret-files?" -> GET /services/{serviceId}/secret-files
• "Get secret-file details?" -> GET /services/{serviceId}/secret-files/{secretFileName}
• "Update a secret-file?" -> PUT /services/{serviceId}/secret-files/{secretFileName}
• "Delete a secret-file?" -> DELETE /services/{serviceId}/secret-files/{secretFileName}
• "List all events?" -> GET /services/{serviceId}/events
• "List all headers?" -> GET /services/{serviceId}/headers
• "Create a header?" -> POST /services/{serviceId}/headers
• "Delete a header?" -> DELETE /services/{serviceId}/headers/{headerId}
• "List all routes?" -> GET /services/{serviceId}/routes
• "Create a route?" -> POST /services/{serviceId}/routes
• "Delete a route?" -> DELETE /services/{serviceId}/routes/{routeId}
• "List all custom-domains?" -> GET /services/{serviceId}/custom-domains
• "Create a custom-domain?" -> POST /services/{serviceId}/custom-domains
• "Get custom-domain details?" -> GET /services/{serviceId}/custom-domains/{customDomainIdOrName}
• "Delete a custom-domain?" -> DELETE /services/{serviceId}/custom-domains/{customDomainIdOrName}
• "Create a verify?" -> POST /services/{serviceId}/custom-domains/{customDomainIdOrName}/verify
• "Create a suspend?" -> POST /services/{serviceId}/suspend
• "Create a resume?" -> POST /services/{serviceId}/resume
• "Create a restart?" -> POST /services/{serviceId}/restart
• "Create a scale?" -> POST /services/{serviceId}/scale
• "Create a preview?" -> POST /services/{serviceId}/preview
• "List all jobs?" -> GET /services/{serviceId}/jobs
• "Create a job?" -> POST /services/{serviceId}/jobs
• "Get job details?" -> GET /services/{serviceId}/jobs/{jobId}
• "Create a cancel?" -> POST /services/{serviceId}/jobs/{jobId}/cancel
• "List all instances?" -> GET /services/{serviceId}/instances
• "Create a run?" -> POST /cron-jobs/{cronJobId}/runs
• "Get event details?" -> GET /events/{eventId}
• "List all logs?" -> GET /logs
• "List all subscribe?" -> GET /logs/subscribe
• "List all values?" -> GET /logs/values
• "Get owner details?" -> GET /logs/streams/owner/{ownerId}
• "Update a owner?" -> PUT /logs/streams/owner/{ownerId}
• "Delete a owner?" -> DELETE /logs/streams/owner/{ownerId}
• "List all resource?" -> GET /logs/streams/resource
• "Get resource details?" -> GET /logs/streams/resource/{resourceId}
• "Update a resource?" -> PUT /logs/streams/resource/{resourceId}
• "Delete a resource?" -> DELETE /logs/streams/resource/{resourceId}
• "Get metrics-stream details?" -> GET /metrics-stream/{ownerId}
• "Update a metrics-stream?" -> PUT /metrics-stream/{ownerId}
• "Delete a metrics-stream?" -> DELETE /metrics-stream/{ownerId}
• "List all cpu?" -> GET /metrics/cpu
• "List all cpu-limit?" -> GET /metrics/cpu-limit
• "List all cpu-target?" -> GET /metrics/cpu-target
• "List all memory?" -> GET /metrics/memory
• "List all memory-limit?" -> GET /metrics/memory-limit
• "List all memory-target?" -> GET /metrics/memory-target
• "List all http-requests?" -> GET /metrics/http-requests
• "List all http-latency?" -> GET /metrics/http-latency
• "List all bandwidth?" -> GET /metrics/bandwidth
• "List all bandwidth-sources?" -> GET /metrics/bandwidth-sources
• "List all disk-usage?" -> GET /metrics/disk-usage
• "List all disk-capacity?" -> GET /metrics/disk-capacity
• "List all instance-count?" -> GET /metrics/instance-count
• "List all active-connections?" -> GET /metrics/active-connections
• "List all replication-lag?" -> GET /metrics/replication-lag
• "List all application?" -> GET /metrics/filters/application
• "List all http?" -> GET /metrics/filters/http
• "List all path?" -> GET /metrics/filters/path
• "List all task-runs-queued?" -> GET /metrics/task-runs-queued
• "List all task-runs-completed?" -> GET /metrics/task-runs-completed
• "List all key-value?" -> GET /key-value
• "Create a key-value?" -> POST /key-value
• "Get key-value details?" -> GET /key-value/{keyValueId}
• "Partially update a key-value?" -> PATCH /key-value/{keyValueId}
• "Delete a key-value?" -> DELETE /key-value/{keyValueId}
• "List all connection-info?" -> GET /key-value/{keyValueId}/connection-info
• "Create a suspend?" -> POST /key-value/{keyValueId}/suspend
• "Create a resume?" -> POST /key-value/{keyValueId}/resume
• "List all redis?" -> GET /redis
• "Create a redis?" -> POST /redis
• "Get redis details?" -> GET /redis/{redisId}
• "Partially update a redis?" -> PATCH /redis/{redisId}
• "Delete a redis?" -> DELETE /redis/{redisId}
• "List all connection-info?" -> GET /redis/{redisId}/connection-info
• "List all postgres?" -> GET /postgres
• "Create a postgre?" -> POST /postgres
• "Get postgre details?" -> GET /postgres/{postgresId}
• "Partially update a postgre?" -> PATCH /postgres/{postgresId}
• "Delete a postgre?" -> DELETE /postgres/{postgresId}
• "List all connection-info?" -> GET /postgres/{postgresId}/connection-info
• "List all recovery?" -> GET /postgres/{postgresId}/recovery
• "Create a recovery?" -> POST /postgres/{postgresId}/recovery
• "Create a suspend?" -> POST /postgres/{postgresId}/suspend
• "Create a resume?" -> POST /postgres/{postgresId}/resume
• "Create a restart?" -> POST /postgres/{postgresId}/restart
• "Create a failover?" -> POST /postgres/{postgresId}/failover
• "List all export?" -> GET /postgres/{postgresId}/export
• "Create a export?" -> POST /postgres/{postgresId}/export
• "List all credentials?" -> GET /postgres/{postgresId}/credentials
• "Create a credential?" -> POST /postgres/{postgresId}/credentials
• "Delete a credential?" -> DELETE /postgres/{postgresId}/credentials/{username}
• "List all projects?" -> GET /projects
• "Create a project?" -> POST /projects
• "Get project details?" -> GET /projects/{projectId}
• "Partially update a project?" -> PATCH /projects/{projectId}
• "Delete a project?" -> DELETE /projects/{projectId}
• "Create a environment?" -> POST /environments
• "List all environments?" -> GET /environments
• "Get environment details?" -> GET /environments/{environmentId}
• "Partially update a environment?" -> PATCH /environments/{environmentId}
• "Delete a environment?" -> DELETE /environments/{environmentId}
• "Create a resource?" -> POST /environments/{environmentId}/resources
• "List all env-groups?" -> GET /env-groups
• "Create a env-group?" -> POST /env-groups
• "Get env-group details?" -> GET /env-groups/{envGroupId}
• "Partially update a env-group?" -> PATCH /env-groups/{envGroupId}
• "Delete a env-group?" -> DELETE /env-groups/{envGroupId}
• "Delete a service?" -> DELETE /env-groups/{envGroupId}/services/{serviceId}
• "Get env-var details?" -> GET /env-groups/{envGroupId}/env-vars/{envVarKey}
• "Update a env-var?" -> PUT /env-groups/{envGroupId}/env-vars/{envVarKey}
• "Delete a env-var?" -> DELETE /env-groups/{envGroupId}/env-vars/{envVarKey}
• "Get secret-file details?" -> GET /env-groups/{envGroupId}/secret-files/{secretFileName}
• "Update a secret-file?" -> PUT /env-groups/{envGroupId}/secret-files/{secretFileName}
• "Delete a secret-file?" -> DELETE /env-groups/{envGroupId}/secret-files/{secretFileName}
• "List all maintenance?" -> GET /maintenance
• "Get maintenance details?" -> GET /maintenance/{maintenanceRunParam}
• "Partially update a maintenance?" -> PATCH /maintenance/{maintenanceRunParam}
• "Create a trigger?" -> POST /maintenance/{maintenanceRunParam}/trigger
• "Create a webhook?" -> POST /webhooks
• "List all webhooks?" -> GET /webhooks
• "Get webhook details?" -> GET /webhooks/{webhookId}
• "Partially update a webhook?" -> PATCH /webhooks/{webhookId}
• "Delete a webhook?" -> DELETE /webhooks/{webhookId}
• "List all events?" -> GET /webhooks/{webhookId}/events
• "List all workflows?" -> GET /workflows
• "Create a workflow?" -> POST /workflows
• "Get workflow details?" -> GET /workflows/{workflowId}
• "Partially update a workflow?" -> PATCH /workflows/{workflowId}
• "Delete a workflow?" -> DELETE /workflows/{workflowId}
• "List all workflowversions?" -> GET /workflowversions
• "Create a workflowversion?" -> POST /workflowversions
• "Get workflowversion details?" -> GET /workflowversions/{workflowVersionId}
• "List all tasks?" -> GET /tasks
• "Get task details?" -> GET /tasks/{taskId}
• "List all task-runs?" -> GET /task-runs
• "Create a task-run?" -> POST /task-runs
• "List all events?" -> GET /task-runs/events
• "Get task-run details?" -> GET /task-runs/{taskRunId}
• "Delete a task-run?" -> DELETE /task-runs/{taskRunId}
• "How to authenticate?" -> See Auth section

Response Tips

• Check response schemas in references/api-spec.lap for field details
• List endpoints may support pagination; check for limit, offset, or cursor params
• Create/update endpoints typically return the created/updated object

References

• Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

Generated from the official API spec by LAP