Skip to main content
The Penumbra API is the REST surface the SDK is built on. Most builders use the SDK, but every capability is reachable directly over HTTP.

​
Base URL

https://pnbr.io/v1
Override it in a self-hosted or staging environment. The SDK exposes the same override through baseUrl.

​
Conventions

  • Authentication: every endpoint requires a Bearer token. See Authentication.
  • Format: requests and responses are JSON. Send Content-Type: application/json on requests with a body.
  • Projects: a project-scoped key makes the project implicit. An organization-scoped key requires project_id on calls that need it, usually as a query parameter or body field.
  • Request ids: responses include a request_id. Include it when you report a problem.

​
A request without the SDK

curl -X POST https://pnbr.io/v1/search \
  -H "Authorization: Bearer $PENUMBRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "pricing objections", "include": ["entities"], "limit": 10}'

​
Endpoints

See Endpoints for the full /v1 catalog grouped by area.