A personal access token (PAT) lets a script or tool use the Tape API as you. You choose which workspaces and apps it can reach and what it's allowed to do.
Note:
The token appears only once. Copy it before you close the dialog. You can't see it again.
A token can't do more than you can. You can only give it capabilities you have yourself.
Revoking stops it immediately. Scripts and tools that use the token stop working at once.
Who can use personal access tokens?
Organization owners, Organization admins, and Members can open
DeveloperinSettings. Guests don't see it. Learn more about organization roles →Each token belongs to you and is used on your behalf. Records it creates or changes show you as the author, and emails it sends go out in your name. To show a tool under its own name, create a separate user for it and create the token from that account.
Create a personal access token
To create a token:
Select your organization name at the top of the sidebar, then select
Settings. You can also select your profile picture, thenPreferences.Under
Features, selectDeveloper.Under
Personal access tokens (PATs), selectNew token.Enter a
Token namethat says what the token is for.Under
Content access, choose the workspaces and apps the token can reach. SelectAllfor everything, including workspaces and apps you add later. A workspace you choose includes all its apps, also apps added later. An app you choose doesn't include its workspace.Under
Capabilities, choose what the token may do, grouped byOrganization,Workspaces,Apps,Records,Automations, andAdvanced. SelectAllfor every capability, including ones added later.Select
Create token.Select
Copy and closeto copy your token and close the dialog.
Paste the token into your script or tool right away. Tape shows it only once. Learn more about the Tape API →
Tip: Create one token per script or tool, with a name you'll recognize, and give it only the access it needs. If a token may have leaked, revoke it first and investigate afterwards.
See your tokens
The Developer page lists your tokens with their Name, Content access, Capabilities, Status, Created, and Last used. Use Search tokens… to find one, or click the Filter icon to show only Active or Revoked tokens.
A token's status is Active until you revoke it, then Revoked. The list shows only the first and last few characters of each token, so you can tell them apart.
Rename, revoke, or delete a token
Click the Actions icon in the row of the token.
Rename: only for active tokens. OpensRename access token. Enter a newToken nameand selectSave.Revoke: stops the token for good. Confirm withRevoke this access token.Delete: removes a revoked token from your list. Confirm withDelete this access token.Deleteonly works for tokens you revoked first, and can't be undone.
Note: Webhooks keep running after you revoke a token. If a script created webhooks with the token, they keep sending messages. Delete them in each app. Learn more about app webhooks →
Personal access token limits
You can have up to 20 active tokens at a time. Revoke one to create another.
A token can reach up to 50 workspaces and 50 apps that you choose. For more, select
All.A token name can have up to 500 characters.
Your old API key
If you still have a personal API key from before, it's listed as API Key. Select Copy API key to copy it, or Delete to remove it. Confirm with Delete this API key. A deleted key stops working immediately and can't be restored. Use a personal access token from now on.
Token errors
"The token could not be created.", "The token could not be renamed.", "The token could not be revoked.", and "The token could not be deleted." mean the action failed. Try again.
If a script gets an access error, check that the token's
Content accessandCapabilitiescover what it does, and that the token isActive.
FAQs
Can I see a token again after I created it?
Can I see a token again after I created it?
No, the token appears only once, when you create it. Create a new token if you lost it, and revoke the old one.
Can I limit a token to one app?
Can I limit a token to one app?
Yes, under Content access, choose only the workspace or app the token should reach.
Does a token expire?
Does a token expire?
No, a token has no expiration date. It stays Active until you revoke it.
Can I change what a token can access later?
Can I change what a token can access later?
No, you can only rename a token. To change its Content access or Capabilities, create a new token and revoke the old one.
Why can't I delete an active token?
Why can't I delete an active token?
Because Delete is only offered for revoked tokens. Revoke the token first.
Are you a developer using the Tape API?
Are you a developer using the Tape API?
Yes, find the full documentation in the Tape developer docs →.
Still have more questions? Find answers and get help from community experts in the Tape community →.
