Skip to content

Create a personal access token

A script that exports your keys, a tool that checks what applies to a team: give it a token of its own instead of your password. It acts as you, can do no more than you can, can be limited to less, expires on its own, and can be revoked at any time.

Tokens are not keys

A personal access token manages Vidai as you. To call models, a program uses a key through the gateway: Issue a key.

Before you start

  • Anyone signed in can create tokens for themselves, from Your account.

Steps

  1. Open the menu under your name, choose Your account, then Personal access tokens.
  2. Choose New personal access token and name it after what uses it.
  3. Choose what it may do. Choose nothing to let it do everything you may do.

    Choice Lets it
    Read See what you can see
    Change people and teams Add, change and remove people and teams
    Change roles Give and remove roles
    Change keys Issue and revoke keys
    Change rules Change rules and guardrails
    Change organisation settings Change the catalogue and organisation settings
  4. Choose when it expires: 7 days, 30 days, 90 days (the default) or 1 year, the most allowed.

  5. Choose Make token and copy the secret. It's shown only now.

Making a personal access token limited to reading, step by step

Check it worked

The list shows the token's start (never the secret), what it may do, when it expires and when it was last used.

Good to know

  • Revoke stops it at once; that can't be undone.
  • A token can still do only what you can: if you lose a role, your tokens lose it too.
  • Disabling a person revokes their API tokens for good.
  • Organisation admins see every token in the organisation on Service accounts › Every API token (Enterprise).