Creating and using API tokens

Unskript API uses API tokens to authenticate your requests.

Create a API Token:

Note: API keys can be created and revoked by users with admin access rights.

  • Log in to your unSkript dashboard.

  • In the top navigation, under "More", click "User Management."

  • There is a tab here that lists all of your API tokens. Click "+Create API Token."

There are three fields for each API token

When you click "Create API Token" you will be able to copy the API Token.

Use of API Token

Authentication to the API is performed by supplying the X-unSkript-API-Key header with API token as it's value.

Example of request to API:

curl --location --request GET '' --header 'X-unSkript-API-Key: <your-api-token>'

Revoke Token

Click the trash can next to the token to remove it from the unSkript system. Once removed, it cannot be recovered.

Your API keys carry the privileges to execute workflows (runbooks) your team owns and view results of executions so be sure to keep them secure! Do not share your API tokens in publicly accessible areas such as GitHub, client-side code, etc. All API requests must be made over HTTPS. Any requests made over plain HTTP will fail. Requests without a valid API token will fail and return a 401 error.

Last updated