The Render API
Manage your Render infrastructure programmatically.
Render provides a public REST API for managing your services and other resources programmatically.
The API supports almost all of the same functionality available in the Render Dashboard. Among other capabilities, it provides endpoints for managing:
- All service types (web services, private services, and so on)
- Managed datastores (Render Postgres and Key Value)
- Render Workflows (including tasks and runs)
- Service deploys
- Environment groups
- Blueprints
- Metrics and logs
- Projects and environments
- Custom domains
- One-off jobs
- Audit logs
- Additional account settings
To request new API functionality, please submit a feature request.
Setup
1. Create an API key
All Render API requests require an API key.
-
Go to your Account Settings page in the Render Dashboard and click Create API key.

-
Give your key a name.
-
Select the workspace your key can access.
-
Grant your key permissions. For details, see Permissions.
-
You can also set permissions for all workspace resources at once:

- All: Grants every permission your member role allows for every resource.
- Read only: Grants Read access to every applicable resource.
- Clear all: Removes all permissions from the key.
-
-
Click Generate API key. Your key is shown in full only once:

API keys are secret credentials!
Don't publicly post your API key, commit it to version control, or otherwise share it with anyone outside your organization. If you believe an API key has been compromised, revoke it.
2. Make your first request
To test your key, call a Render API endpoint it has permission to access.
For example, a key with Read access to services can call the List services endpoint. Replace {API_KEY} with your key and run the following:
If your API key is valid, the request returns a 200 response and an array of services.
For details on managing keys and their permissions, see API keys.
API reference
Open the API reference for a comprehensive list of supported endpoints. The reference is interactive, and it provides example usage in multiple programming languages.

OpenAPI spec
The Render API is described by an OpenAPI 3.0 spec. The spec is available in JSON format at the following URL:
You can use this spec to generate custom clients and with other tooling.
Render's OpenAPI spec is subject to change.
The API itself will maintain backward compatibility, but details of the describing spec (such as names for endpoints and tags) might change over time. This might affect custom clients or other tools that rely on the spec.