Getting Started

You can access the Decagon API at


Authenticating to the API is done using an API key that is passed in an Authentication header. All requests to an API endpoint, must contain the following header:

Authorization: Bearer <API_KEY>

For instance, if you were making a request to the health endpoint in Python, your code would look like this:

import requests

API_KEY = "your_api_key"
    "Authorization": f"Bearer {API_KEY}"

response = requests.get(ENDPOINT, headers=HEADERS)

Rate Limits

Since Decagon APIs are not used for user-facing requests (like generating message), there is a limit of 1 request per second across all API endpoints.

Gross violation of the rate limit will lead to automatic banning of your IP address.

Last updated