Overview
Programmatic API access uses user-owned personal access tokens. A token identifies the user who created it, and API requests made with that token inherit that user’s project access and permissions.
Use personal access tokens for user-owned scripts, local tools, CI jobs, and SDK usage. Tokens can be scoped, rate-limited, given an expiration date, and revoked at any time.
Treat personal access tokens like passwords. Store them in environment variables or a secret manager, never commit them to source control, and revoke any token that may have been exposed.
Create A Token In The UI
- Sign in to Davinci.
- Click your account icon in the top-right corner.
- Open Settings.
- Select Connections.
- In Personal Access Tokens, click New Token.
- Fill out the token options and click Create Token.
- Copy the token immediately. It is shown only once.
Token Options
Tokens use this format:
Production tokens start with dav_ak_live_; non-production tokens start with dav_ak_test_.
The full token is 110 characters long:
dav_ak_live_ or dav_ak_test_ prefix- 12-character key id segment
- 86-character secret segment
Only the key id is stored/displayed later. The full token cannot be recovered after the creation dialog closes.
Use The Token
Use the token as a bearer token:
For SDK usage, pass the token as apiKey:
