API Token

This guide provides step-by-step instructions on how to generate a token for the Select Star API and access its features and data.

Create a Token

In order to access the Select Star API, you'll need to first generate a token.

In your Account Settings page, under Client API Token, click on Manage API Tokens :

Then, in the modal, click on the Create button.

Copy the text in the API Token field to use as the token in API requests.

API tokens have no expiration, but they can be deleted and then recreated manually.

Making Authenticated Requests

All Select Star API endpoints require authentication, so the token must be included it in all requests. Set the Authorization header for bearer authentication like the following:

Authorization: Token <token>

Please note that for authorization type, you must use Token and not Bearer

For example, in curl, set the header using the -H flag:

curl https://api.production.selectstar.com/v1/tables/ -H "Authorization: Token <your_token>"

If the token is missing or invalid, the endpoint will return 401: Unauthorized with one of the following messages in the body:

{
    "detail": "Authentication credentials were not provided."
}

{
    "detail": "Given token not valid for any token type",
    "code": "token_not_valid",
    "messages": [
        {
            "token_class": "AccessToken",
            "token_type": "access",
            "message": "Token is invalid or expired"
        }
    ]
}