Skip to content
LogoLogo

How to create and revoke an API key

This guide shows you how to give your code access to the Picked API. Use a key where your own code calls the API, such as a server-side integration.

An API key does not sign the CLI in. The CLI reads a session, which picked login writes. See How to authenticate the CLI for the commands that CI can run without one.

Create a key

  1. Open your organization.
  2. Click API Keys.
  3. Click Create API Key.
  4. Enter a Name, such as Production key.
  5. Set Project to one project. The default, All projects, gives the key every project.
  6. Choose the Permissions that your integration needs.
  7. Click Create API Key.

Revoke a key

  1. Open the API keys list.
  2. Click Revoke next to the key.
  3. Click Revoke Key to confirm.

Picked invalidates the key immediately. No later request can use it.