API reference
Copy page
Every Kelly API operation and Kelly Wire topic, with the base URL, headers and downloads in one place.
BasicsLink to this section
| What | Where |
|---|---|
| Base URL | https://api.askkelly.ai |
| Authentication | Authorization: Bearer $KELLY_API_KEY (authentication) |
| Versioning | Api-Version: YYYY-MM-DD; omitted means 2026-10-05 (conventions) |
| Kelly Wire | wss://wire.askkelly.ai/v1 (streaming) |
| API definition | OpenAPI 3.2.0, version 2026-10-05 |
| Wire definition | AsyncAPI 3.1.0, version 2026-10-05 |
| Request collection | Postman collection |
| Generator | askkelly-devdocs 0.1.0, built from API version 2026-10-05 |
GroupsLink to this section
- status: Check that the API answers and see who it thinks you are and what you have left.
- reference: Look up sourced, dated rules, laws, tax, operator policies, terms and help.
- answers: Ask a question in words and get a sourced answer, and the method behind any number.
- Kelly Wire: Kelly Wire: the live socket, tickets and single-topic streams.
- Wire topics: Every topic Kelly Wire defines and the messages each sends.
- Errors: One page per error code: what it means, how to fix it and whether to retry.
All operationsLink to this section
| Method | Path | Title | Status | Group |
|---|---|---|---|---|
| GET | /health | Check that the service answers | live | status |
| GET | /v1/status | See who is calling and what is left | live | status |
| GET | /v1/reference | Search published reference entries | live | reference |
| GET | /v1/reference/{topic_id} | Get a published reference entry | live | reference |
| POST | /v1/wire/tickets | Get a Kelly Wire ticket | live | Kelly Wire |
| GET | /v1/stream/{topic} | Stream one topic as server-sent events | live | Kelly Wire |
| POST | /v1/answers | Ask a question | live | answers |
Generated from Kelly API 2026-10-05.