Authentication

The Render REST API uses API keys for authenticating requests. To create and view your API keys, go to your personal Account Settings page on Render.

Your API keys will have the ability to manage resources owned by both you and any teams you're a part of. Resources like services will have an owner_id that specifies what user or team directly owns them. For more details on how resource ownership works, check out the Owners section of our docs.

🚧
Warning
Your API key allows you to do anything you would with your Render account's dashboard, so make sure to keep it secure. Don't publicly post your API key, commit it to a public GitHub repo, or otherwise share it with anyone who you wouldn't want control of your Render resources.

To authenticate a request, provide your API token through bearer authentication in the request header. An example is shown below:

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

🚧Warning

🚧
Warning