Developers

API overview

Build on your brains over plain HTTP. List brains, ask grounded questions, retrieve context, and add sources — all with a single API key.

Base URL#

All endpoints live under one host. Paths in this reference are relative to it.

https://ounie.com

Authentication#

Every request authenticates with a personal API key in an Authorization header. The same key carries your full account access, so treat it like a password.

Authorization: Bearer ounie_live_…

OAuth access tokens (ounie_at_…), used by one-click connectors, are accepted on the same endpoints. Most server-to-server integrations use an API key.

API keys#

Create and revoke keys in Settings → API keys. A key looks like ounie_live_ followed by a long random string, and the full value is shown exactly once — copy it then. Only a hash is stored, so a lost key cannot be recovered; revoke it and create another. See plan details on the pricing page.

You can also create a key over the API:

curl -s -X POST https://ounie.com/api/user/api-keys \
  -H "Authorization: Bearer ounie_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"my integration"}'

Next#

See the REST API for endpoints, the MCP guide to use a brain inside an AI client, or agent payments for paid brains.