API Tokens

Introduction

Section allows you to create API Tokens that belongs to your user. API Tokens will have the same permissions as your user has at the time of creation. When your user is deleted, this key will persist.

Creating an API Token

Go to the User Setting page by clicking on your profile picture in the top right then select API Tokens:

Create API Token

Enter a description for what this API Token will be used for, and then click the Add button:

Create API Token Result

Copy the token value and store it somewhere securely. As the warning says, this value cannot be retrieved later. If you loose this value you will need to create a new token and delete the old one.

The API Tokens you have created will be listed on this page. They can be deleted by clicking the X button next to the Token description.

Using an API Token

Use your API Token by adding it to your requests in the Section-Token header.

curl -H "Section-Token: YOUR-API-TOKEN-HERE" https://aperture.section.io/api/v1

API Tokens can also be used to authenticate git when accessing the Section config repository for your application.
When git prompts for your username, enter section-token, and use the API Token value as the password.