Connect an agent.In five minutes.

1. Create a key

Open the agent in Blue Falnoa, then Settings, then Connect in 5 minutes (administrator). Create an ingest key. It is shown once and stored only as a hash. Rotating it revokes the old key immediately.

Send it as Authorization: Bearer bfa_… on every call.

2. Send a message

The first call creates the conversation and later calls append to it. Messages with an id are safe to retry: one that was already stored is skipped.

curl -X POST https://YOUR-INSTANCE/api/agent/v1/conversations/order-123/messages \
  -H "Authorization: Bearer bfa_…" \
  -H "Content-Type: application/json" \
  -d '{"messages": [
        {"id": "m1", "role": "user", "content": "Where is my order?"},
        {"id": "m2", "role": "assistant", "content": "It ships tomorrow."}
      ]}'

The same page offers ready-made snippets for curl, Python, TypeScript, OpenAI, LangChain and n8n, and notices the first message by itself.

3. If nothing arrives, run doctor

Doctor says whether the key is wrong or rotated (401), the agent is not approved in its registry, or its monthly budget is reached. When the key is valid but the first message would be refused, ok is false and problems says why.

python -m blue_falnoa doctor https://YOUR-INSTANCE bfa_…
# or: curl -H "Authorization: Bearer bfa_…" https://YOUR-INSTANCE/api/agent/v1/ping

What happens next

All guides