Authentication

You authenticate all requests to the Render API with an API key. Create and manage API keys from your Account Settings page in the Render Dashboard:

An API key provides access to all workspaces you belong to. Each resource object returned by the API includes an owner_id field that indicates which workspace owns that resource. You can obtain the ID for each of your workspaces with the List Workspaces endpoint.

⚠️

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 from the Render Dashboard and create a new one.

Providing an API key

You include your API key in each request via the Authorization HTTP header:

Authorization: Bearer API_KEY_GOES_HERE

Consult your HTTP library's documentation for the recommended way to set this header.

To confirm that your API key works as expected, send your first API request with the following curl command (substitute your API key where indicated):

curl --request GET \
     --url 'https://api.render.com/v1/services?limit=3' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer API_KEY_GOES_HERE'