Skip to main content
API keys let scripts, CI/CD pipelines and other tools access your UptimeIO account. Create and manage them here in the dashboard.

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.
Free organizations do not see these fields.
5

Copy the key

Click Copy API Key and store it in your secret manager.
You can see the full key only once. It cannot be retrieved later. If you lose it, rotate it or create a new key.

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.

Use the key

Use the key from your scripts, CI/CD pipelines and other tools. For request details, rate limit headers and errors, see Authentication.