Skip to content

API keys

Every key belongs to a project. The API keys page in the Fourier Platform console shows the keys of the project selected in the sidebar’s project switcher. Every organization starts with a project named Default; administrators add more with New project in the switcher. An organization can have up to 20 projects and 100 active keys.

Any member can create keys in an active project. To create a key, follow these steps:

  1. In the sidebar, select the project in the project switcher.

  2. Click API keys, and then click Create key.

  3. In the Name field, enter a name of up to 80 characters that says what uses the key, for example the service and environment.

  4. For Expiration, select Never, 30 days, 90 days, or 1 year.

  5. Click Create key.

The dialog then shows the full key once, with the message Copy it now. It cannot be shown again. Copy the key to your secret store before you click Done. If you lose a key, create a replacement and revoke the lost one.

If the project is archived, the page shows This project is archived. Its keys do not work and hides Create key.

The list shows Active keys by default; use the status filter to see Expired, Revoked, or All keys. Each row shows the key ID with the last four characters of the secret, who created it, when it was last used, and when it expires.

Use the actions menu in the key’s row. Administrators see it on every key; members see it only on the keys they created. The menu has the following commands:

  • Rename changes the name only.
  • Revoke stops the key immediately and keeps it in the list as Revoked. Requests with the key fail with status 401 and code api_key_revoked.
  • Delete removes the key from the list and, if the key was active, stops it at the same time. You can’t undo a revocation or a deletion.
  1. On the API keys page, create a replacement key in the same project.

  2. Deploy the replacement key to the service.

  3. On the API keys page, confirm that the replacement key’s Last used value updates and the previous key’s value stops changing.

  4. Revoke the previous key.