DocumentationAPI ReferenceAPI Authentication
API Reference

API Authentication

How to authenticate requests to the Castor Flow API.


Every API request must be authenticated with an API key. Keys are generated in your account settings and tied to your Castor Flow account.

Generating a key

Go to Settings → API → Generate New Key. Give it a descriptive name and copy it immediately — it will not be shown again.

Making authenticated requests

curl https://api.castorflow.com/v1/businesses \
  -H "Authorization: Bearer YOUR_API_KEY"

Error responses

  • 401 Unauthorized — missing or invalid API key
  • 403 Forbidden — key does not have permission for this action

⚠️ Warning

Never expose your API key in client-side code. Use it only in server-side environments.