Skip to content
Fotobots Partner Docs

Managing API Keys

To connect your software or race timing platform to Fotobots, you must generate an API Key.

Step-by-Step: Creating an API Key

  1. Log in to the Fotobots Web Admin.
  2. In the left navigation sidebar, click API Keys (/api-keys).
  3. Click the Create New Key button in the top right.
  4. Enter a descriptive name (e.g. Marathon-Timing-App-Production).
  5. Select the required permissions:
    • search:read (For runner search portals)
    • photo:upload (For photographer upload stations)
  6. Click Generate Key.

[!IMPORTANT] Copy Your Key Immediately: For security reasons, the full API key will only be displayed once upon creation. Store it securely in your secret manager or environment configuration (.env).

Revoking an API Key

If an API key is accidentally committed to a public repository or compromised:

  1. Navigate to API Keys in the Web Admin.
  2. Locate the key and click the Revoke / Delete icon.
  3. The key is deactivated immediately across all global edge locations.