Skip to main content
An API key authenticates requests to Tella on your workspace’s behalf. You need one for the public API and webhooks, the Tella MCP server, and agent skills. To manage keys, click your avatar, go to Settings, then API Keys under Other.
Members with the Viewer role cannot open this page. Ask a workspace owner or member to create a key for you.

​
Create a key

  1. Go to Settings → API Keys.
  2. Click Create key.
  3. Give the key a name that says where it will be used, for example, Production API key. The name is only a label for you; it does not affect what the key can do.
  4. Click Create.
  5. Copy the key straight away and store it somewhere safe.
The full key is shown once, at the moment you create it. Tella cannot show it to you again. If you lose it, revoke the key and create a new one.

​
Read the key list

Each key in the table shows:
  • Name: the label you gave it.
  • Key: the first few characters of the key. This prefix is enough to tell keys apart, but it is not the key itself.
  • Created: when the key was made.
  • Last used: when a request last used it, or Never if nothing has used it yet.
Last used is the quickest way to find keys you can safely retire: anything that says Never, or that has not been used in months, is a good candidate to revoke.

​
Revoke a key

  1. Find the key in the table.
  2. Click Revoke.
  3. Confirm.
Revoking takes effect immediately, and any application still using that key stops working. If a script or integration breaks right after you revoke, that is why. Issue a new key and update the integration with it.

​
Keep keys safe

  • Treat a key like a password. Anyone holding it can act on your workspace through the API.
  • Do not commit keys to a repository, paste them into a prompt, or share them in chat.
  • Use a separate key per integration, so you can revoke one without breaking the others.
You can have up to 10 API keys at a time. If creating a key fails with “Maximum of 10 API keys allowed per user”, revoke one you no longer use and try again.

​
Use your key

For how to send the key with a request, see the authentication guide in the developer documentation.