Create an API key
1
Open the API Keys tab
Click Settings in the sidebar, then select the API Keys tab.
2
Create the key
Click Create API Key. Enter a Name that describes its purpose, such as
CI/CD Pipeline or Terraform.3
Choose the permissions
Select Permissions:
Start with Read Only unless the tool needs to make changes.
4
Limit the key (Pro and Scale)
On a paid plan, two optional fields let you narrow what the key can do:
- Project: choose a project to restrict the key to that project’s data. Leave it on All projects for no restriction.
- Requests per minute: enter a number to cap how many requests this key can make each minute. The cap cannot exceed your plan’s limit (200 on Pro, 500 on Scale). Leave it empty for no extra cap.
5
Copy the key
Click Copy API Key and store it in your secret manager.
Rotate or delete a key
Each key in the list shows its name, a preview of the key and its permissions. A key with a project restriction or its own request limit shows them too.
Who can manage keys
Only owners and admins can create, rotate and delete API keys. Other roles see the list, or an empty state if no keys exist.Plan differences
- The request limit is shared by all keys in your organization. A key with its own limit can use less than the organization limit, never more.
- A key restricted to one project can only reach that project.
- Plan rules are checked on every request. If you downgrade, existing keys are kept.
- Keys created by any admin count toward your organization’s key limit.