Skip to main content
Workspace secrets let you create and manage API keys for programmatic access to your workspace. Use these keys to stream audit logs or pull workspace data into an external system via the Monitoring API.. Keys are workspace-owned, so they stay active even if the member who created them leaves the workspace.
Important:
  • Workspace secrets are available on Enterprise plans only.
  • Only workspace owners and admins can view and manage secrets.
Manage credentials and access tokens for your workspace.
For a full list of supported APIs, see the API reference.

Creating an API key

You can create up to 10 API keys per workspace.
Important:
  • Copy your key immediately after creating it. You will not be able to see it again.
  • Treat it like a password: it grants access to your workspace data via the API.
To create an API key:
  1. Click your workspace name at the top left and click Settings.
  2. Click Secrets in the sidebar.
  3. Click + Create API Key.
  4. Enter a name for the key (required) and an optional description.
  5. Click Create Key.
  6. Copy the key and store it somewhere safe.
  7. Click Done.
Creating an API key for your workspace

Managing your API keys

From the Secrets page, you can view all your keys along with who created them, when they were created, and when they were last used. Click the More Actions icon next to a key to edit, disable, or delete it. To manage an API key:
  1. Click your workspace name at the top left and click Settings.
  2. Click Secrets in the sidebar.
  3. Click the More Actions icon next to the key you want to manage and select an option:
    • Edit: Update the key’s name or description.
    • Disable key: Temporarily prevent the key from being used without deleting it.
    • Delete key: Permanently remove the key.
Managing your workspace API keys