Authentication
Auth Tokens
Authentication tokens are passed using an auth header, and are used to authenticate as a user or organization account with the API. In our documentation, we have several placeholders that appear between curly braces or chevrons, such as {API_KEY}
or <auth_token>
, which you will need to replace with one of your authentication tokens in order to use the API call effectively.
For example, when the documentation says:
curl -H 'Authorization: Bearer {TOKEN}' https://sentry.io/api/0/projects/
If your authentication
1a2b3c
, then the command should be:
curl -H 'Authorization: Bearer 1a2b3c' https://sentry.io/api/0/projects/
You can create authentication tokens within Sentry by creating an internal integration. This is also available for self-hosted Sentry.
User authentication tokens
Some API endpoints require an authentication
The endpoints that require a user authentication token are specific to your user, such as List Your Organizations.
DSN Authentication
Some API endpoints may allow
curl -H 'Authorization: DSN {DSN}' https://sentry.io/api/0/projects/
API Keys
Note
API keys are a legacy means of authenticating. They will still be supported but are disabled for new accounts. You should use authentication tokens wherever possible.
API keys are passed using HTTP Basic auth where the username is your api key, and the password is an empty value.
As an example, to get information about the
curl -u {API_KEY}: https://sentry.io/api/0/projects/
You must pass a value for the password, which is the reason the :
is present in our example.
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").