render-public-api

name	render-public-api
description	Render Public API skill. Use when working with Render Public for blueprints, owners, disks. Covers 196 endpoints.
version	1.0.0
generator	lapsh

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

Method	Path	Description
GET	/blueprints	List Blueprints
POST	/blueprints/validate	Validate Blueprint
GET	/blueprints/{blueprintId}	Retrieve Blueprint
PATCH	/blueprints/{blueprintId}	Update Blueprint
DELETE	/blueprints/{blueprintId}	Disconnect Blueprint
GET	/blueprints/{blueprintId}/syncs	List Blueprint syncs

owners

Method	Path	Description
PATCH	/owners/{ownerId}/members/{userId}	Update workspace member role
DELETE	/owners/{ownerId}/members/{userId}	Remove workspace member
GET	/owners	List workspaces
GET	/owners/{ownerId}	Retrieve workspace
GET	/owners/{ownerId}/members	List workspace members
GET	/owners/{ownerId}/audit-logs	List workspace audit logs

disks

Method	Path	Description
GET	/disks	List disks
POST	/disks	Add disk
GET	/disks/{diskId}	Retrieve disk
PATCH	/disks/{diskId}	Update disk
DELETE	/disks/{diskId}	Delete disk
GET	/disks/{diskId}/snapshots	List snapshots
POST	/disks/{diskId}/snapshots/restore	Restore snapshot

users

Method	Path	Description
GET	/users	Get the authenticated user

organizations

Method	Path	Description
GET	/organizations/{orgId}/audit-logs	List organization audit logs

notification-settings

Method	Path	Description
GET	/notification-settings/owners/{ownerId}	Retrieve notification settings
PATCH	/notification-settings/owners/{ownerId}	Update notification settings
GET	/notification-settings/overrides	List notification overrides
GET	/notification-settings/overrides/services/{serviceId}	Retrieve notification override
PATCH	/notification-settings/overrides/services/{serviceId}	Update notification override

registrycredentials

Method	Path	Description
GET	/registrycredentials	List registry credentials
POST	/registrycredentials	Create registry credential
GET	/registrycredentials/{registryCredentialId}	Retrieve registry credential
PATCH	/registrycredentials/{registryCredentialId}	Update registry credential
DELETE	/registrycredentials/{registryCredentialId}	Delete registry credential

services

Method	Path	Description
GET	/services	List services
POST	/services	Create service
GET	/services/{serviceId}	Retrieve service
PATCH	/services/{serviceId}	Update service
DELETE	/services/{serviceId}	Delete service
POST	/services/{serviceId}/cache/purge	Purge Web Service Cache
GET	/services/{serviceId}/deploys	List deploys
POST	/services/{serviceId}/deploys	Trigger deploy
GET	/services/{serviceId}/deploys/{deployId}	Retrieve deploy
POST	/services/{serviceId}/deploys/{deployId}/cancel	Cancel deploy
POST	/services/{serviceId}/rollback	Roll back deploy
GET	/services/{serviceId}/env-vars	List environment variables
PUT	/services/{serviceId}/env-vars	Update environment variables
GET	/services/{serviceId}/env-vars/{envVarKey}	Retrieve environment variable
PUT	/services/{serviceId}/env-vars/{envVarKey}	Add or update environment variable
DELETE	/services/{serviceId}/env-vars/{envVarKey}	Delete environment variable
GET	/services/{serviceId}/secret-files	List secret files
PUT	/services/{serviceId}/secret-files	Update secret files
GET	/services/{serviceId}/secret-files/{secretFileName}	Retrieve secret file
PUT	/services/{serviceId}/secret-files/{secretFileName}	Add or update secret file
DELETE	/services/{serviceId}/secret-files/{secretFileName}	Delete secret file
GET	/services/{serviceId}/events	List events
GET	/services/{serviceId}/headers	List header rules

cron-jobs

Method	Path	Description
POST	/cron-jobs/{cronJobId}/runs	Trigger cron job run
DELETE	/cron-jobs/{cronJobId}/runs	Cancel running cron job

events

Method	Path	Description
GET	/events/{eventId}	Retrieve event

logs

Method	Path	Description
GET	/logs	List logs
GET	/logs/subscribe	Subscribe to new logs
GET	/logs/values	List log label values
GET	/logs/streams/owner/{ownerId}	Retrieve log stream
PUT	/logs/streams/owner/{ownerId}	Update log stream
DELETE	/logs/streams/owner/{ownerId}	Delete log stream
GET	/logs/streams/resource	List log stream overrides
GET	/logs/streams/resource/{resourceId}	Retrieve log stream override
PUT	/logs/streams/resource/{resourceId}	Update log stream override
DELETE	/logs/streams/resource/{resourceId}	Delete log stream override

metrics-stream

Method	Path	Description
GET	/metrics-stream/{ownerId}	Retrieve metrics stream
PUT	/metrics-stream/{ownerId}	Create or update metrics stream
DELETE	/metrics-stream/{ownerId}	Delete metrics stream

metrics

Method	Path	Description
GET	/metrics/cpu	Get CPU usage
GET	/metrics/cpu-limit	Get CPU limit
GET	/metrics/cpu-target	Get CPU target
GET	/metrics/memory	Get memory usage
GET	/metrics/memory-limit	Get memory limit
GET	/metrics/memory-target	Get memory target
GET	/metrics/http-requests	Get HTTP request count
GET	/metrics/http-latency	Get HTTP latency
GET	/metrics/bandwidth	Get bandwidth usage
GET	/metrics/bandwidth-sources	Get bandwidth usage breakdown by traffic source
GET	/metrics/disk-usage	Get disk usage
GET	/metrics/disk-capacity	Get disk capacity
GET	/metrics/instance-count	Get instance count
GET	/metrics/active-connections	Get active connection count
GET	/metrics/replication-lag	Get replica lag
GET	/metrics/filters/application	List queryable instance values
GET	/metrics/filters/http	List queryable status codes and host values
GET	/metrics/filters/path	List queryable paths
GET	/metrics/task-runs-queued	Get task runs queued count
GET	/metrics/task-runs-completed	Get task runs completed count

key-value

Method	Path	Description
GET	/key-value	List Key Value instances
POST	/key-value	Create Key Value instance
GET	/key-value/{keyValueId}	Retrieve Key Value instance
PATCH	/key-value/{keyValueId}	Update Key Value instance
DELETE	/key-value/{keyValueId}	Delete Key Value instance
GET	/key-value/{keyValueId}/connection-info	Retrieve Key Value connection info
POST	/key-value/{keyValueId}/suspend	Suspend Key Value instance
POST	/key-value/{keyValueId}/resume	Resume Key Value instance

redis

Method	Path	Description
GET	/redis	List Redis instances
POST	/redis	Create Redis instance
GET	/redis/{redisId}	Retrieve Redis instance
PATCH	/redis/{redisId}	Update Redis instance
DELETE	/redis/{redisId}	Delete Redis instance
GET	/redis/{redisId}/connection-info	Retrieve Redis connection info

postgres

Method	Path	Description
GET	/postgres	List Postgres instances
POST	/postgres	Create Postgres instance
GET	/postgres/{postgresId}	Retrieve Postgres instance
PATCH	/postgres/{postgresId}	Update Postgres instance
DELETE	/postgres/{postgresId}	Delete Postgres instance
GET	/postgres/{postgresId}/connection-info	Retrieve Postgres connection info
GET	/postgres/{postgresId}/recovery	Retrieve point-in-time recovery status
POST	/postgres/{postgresId}/recovery	Trigger point-in-time recovery
POST	/postgres/{postgresId}/suspend	Suspend Postgres instance
POST	/postgres/{postgresId}/resume	Resume Postgres instance
POST	/postgres/{postgresId}/restart	Restart Postgres instance
POST	/postgres/{postgresId}/failover	Failover Postgres instance
GET	/postgres/{postgresId}/export	List Postgres exports
POST	/postgres/{postgresId}/export	Create Postgres export
GET	/postgres/{postgresId}/credentials	List PostgreSQL Users
POST	/postgres/{postgresId}/credentials	Create PostgreSQL User
DELETE	/postgres/{postgresId}/credentials/{username}	Delete PostgreSQL User

projects

Method	Path	Description
GET	/projects	List projects
POST	/projects	Create project
GET	/projects/{projectId}	Retrieve Project
PATCH	/projects/{projectId}	Update project
DELETE	/projects/{projectId}	Delete project

environments

Method	Path	Description
POST	/environments	Create environment
GET	/environments	List environments
GET	/environments/{environmentId}	Retrieve environment
PATCH	/environments/{environmentId}	Update environment
DELETE	/environments/{environmentId}	Delete environment
POST	/environments/{environmentId}/resources	Add resources to environment
DELETE	/environments/{environmentId}/resources	Remove resources from environment

env-groups

Method	Path	Description
GET	/env-groups	List environment groups
POST	/env-groups	Create environment group
GET	/env-groups/{envGroupId}	Retrieve environment group
PATCH	/env-groups/{envGroupId}	Update environment group
DELETE	/env-groups/{envGroupId}	Delete environment group
POST	/env-groups/{envGroupId}/services/{serviceId}	Link service
DELETE	/env-groups/{envGroupId}/services/{serviceId}	Unlink service
GET	/env-groups/{envGroupId}/env-vars/{envVarKey}	Retrieve environment variable
PUT	/env-groups/{envGroupId}/env-vars/{envVarKey}	Add or update environment variable
DELETE	/env-groups/{envGroupId}/env-vars/{envVarKey}	Remove environment variable
GET	/env-groups/{envGroupId}/secret-files/{secretFileName}	Retrieve secret file
PUT	/env-groups/{envGroupId}/secret-files/{secretFileName}	Add or update secret file
DELETE	/env-groups/{envGroupId}/secret-files/{secretFileName}	Remove secret file

maintenance

Method	Path	Description
GET	/maintenance	List maintenance runs
GET	/maintenance/{maintenanceRunParam}	Retrieve maintenance run
PATCH	/maintenance/{maintenanceRunParam}	Update maintenance run
POST	/maintenance/{maintenanceRunParam}/trigger	Trigger maintenance run

webhooks

Method	Path	Description
POST	/webhooks	Create a webhook
GET	/webhooks	List webhooks
GET	/webhooks/{webhookId}	Retrieve a webhook
PATCH	/webhooks/{webhookId}	Update a webhook
DELETE	/webhooks/{webhookId}	Delete a webhook
GET	/webhooks/{webhookId}/events	List webhook events

workflows

Method	Path	Description
GET	/workflows	List workflows
POST	/workflows	Create a workflow
GET	/workflows/{workflowId}	Retrieve workflow
PATCH	/workflows/{workflowId}	Update workflow
DELETE	/workflows/{workflowId}	Delete workflow

workflowversions

Method	Path	Description
GET	/workflowversions	List workflow versions
POST	/workflowversions	Deploy a workflow version
GET	/workflowversions/{workflowVersionId}	Retrieve workflow version

tasks

Method	Path	Description
GET	/tasks	List tasks
GET	/tasks/{taskId}	Retrieve task

task-runs

Method	Path	Description
GET	/task-runs	List task runs
POST	/task-runs	Run task
GET	/task-runs/events	Stream realtime events (SSE)
GET	/task-runs/{taskRunId}	Retrieve task run
DELETE	/task-runs/{taskRunId}	Cancel task run

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}

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