render-public-api — quality + safety report

---
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 |
| POST | /services/{serviceId}/headers | Add header rule |
| PUT | /services/{serviceId}/headers | Replace header rules |
| DELETE | /services/{serviceId}/headers/{headerId} | Delete header rule |
| GET | /services/{serviceId}/routes | List redirect/rewrite rules |
| POST | /services/{serviceId}/routes | Add redirect/rewrite rules |
| PATCH | /services/{serviceId}/routes | Update redirect/rewrite rule priority |
| PUT | /services/{serviceId}/routes | Update redirect/rewrite rules |
| DELETE | /services/{serviceId}/routes/{routeId} | Delete redirect/rewrite rule |
| GET | /services/{serviceId}/custom-domains | List custom domains |
| POST | /services/{serviceId}/custom-domains | Add custom domain |
| GET | /services/{serviceId}/custom-domains/{customDomainIdOrName} | Retrieve custom domain |
| DELETE | /services/{serviceId}/custom-domains/{customDomainIdOrName} | Delete custom domain |
| POST | /services/{serviceId}/custom-domains/{customDomainIdOrName}/verify | Verify DNS configuration |
| POST | /services/{serviceId}/suspend | Suspend service |
| POST | /services/{serviceId}/resume | Resume service |
| POST | /services/{serviceId}/restart | Restart service |
| POST | /services/{serviceId}/scale | Scale instance count |
| PUT | /services/{serviceId}/autoscaling | Update autoscaling config |
| DELETE | /services/{serviceId}/autoscaling | Delete autoscaling config |
| POST | /services/{serviceId}/preview | Create service preview (image-backed) |
| GET | /services/{serviceId}/jobs | List jobs |
| POST | /services/{serviceId}/jobs | Create job |
| GET | /services/{serviceId}/jobs/{jobId} | Retrieve job |
| POST | /services/{serviceId}/jobs/{jobId}/cancel | Cancel running job |
| GET | /services/{serviceId}/instances | List instances |

### 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
| Metho

… (truncated)