Personal Access Tokens

Overview

You now have the option to use personal access tokens (PATs) in Cinchy, which are alternatives to using passwords for authentication. Like Cinchy Bearer Tokens, you can use a Cinchy PAT to call the Cinchy API as your current user, meaning your associated access controls will be honoured as well. Cinchy PATs, however, have an expiration date of up to 1 year. A single user can have up to 5 PATs active at one time.

Use Cases

• For API authentication.
• To run a job as another user when using the Connections CLI.
• Using PATs in Excel or PowerBI.

Create a PAT

1. From the Cinchy homepage, navigate to your User Settings > Tokens. Any tokens that you make will appear here. You will also be able to see any expired tokens.

2. Click Generate New Token.

caution

Note: You can have up to 5 active (non-expired) tokens at a time. Once you reach that threshold, the “Generate New Token” button won't work.

3. Input the following information about your PAT and click Generate:

4. Token Name

5. Description

6. Expiration

4. Once generated, make sure to copy down the PAT somewhere secure. You won't be able to view the PAT again once you navigate away from this screen.

Delete a PAT

1. From the Cinchy homepage, navigate to your User Settings > Tokens. Any tokens that you make will appear here.
2. Click the “Delete” button next to the applicable PAT.

Use a PAT in an API

PATs can be used within APIs by prefixing the token with Bearer and passing it in the Header.

Name	Data Type	Description
Authorization	string	Bearer <personal_access_token>