Skip to main content
API keys authenticate your app, not a member. Use them on restaurant and location Discovery routes. They are the only credential those routes accept.

Format

API keys are 40-character strings with a prefix that indicates how they were issued:
fly_live_ keys are production keys; fly_test_ keys are staging/dev keys. The environment binding is server-side: your key is scoped to the DeveloperApp and environment it was minted under. Use the key you received in your onboarding email for the environment you were provisioned for. Send the key in X-API-Key:

What API keys cover

From the kitchen - Discovery routes use the API key. Member-acting routes use OAuth. The two do not substitute for each other.
Chef’s warning - API keys are server-side only. Every call that carries an API key must originate from your backend, never from a browser, mobile client, or any code shipped to users. Don’t embed them in client-side bundles, public repos, screenshots, or environment variables checked into source. A key visible in a client is a key you have to assume is compromised. Treat them as you would a password, and route Discovery calls through your own backend rather than calling the API directly from the client.

If a key leaks

Contact Blackbird support to revoke and issue a new key. Old keys stop working immediately on revocation.

Mixing environments

Don’t reuse a key across environments. Your fly_test_ staging key authenticates against the staging API; your fly_live_ production key authenticates against the production API. They’re issued separately and aren’t substitutes for each other.