API Reference
Every endpoint of Bilby's REST API, with its parameters, request body and responses.
1 min read · Updated 13 Nov 2026 · For developers
This reference is made from the API's own code, so it lists exactly what the API accepts and returns. To see how the calls fit together, start with Your first API call.
Base URL
Every path below starts at https://pulse.bilby.ai, so the full address of a call looks like
https://pulse.bilby.ai/api/v1/conversations.
Authentication
Send a personal API key in the Authorization header of every request:
curl https://pulse.bilby.ai/api/v1/organizations \
-H "Authorization: Bearer $BILBY_API_KEY"A key acts as the person who made it, in the organizations it's scoped to. If it covers more than
one organization, name one with organizationId on each request. API keys
shows how to make, scope and revoke them.
Endpoints
Organizations
Conversations
- GET
/api/v1/conversationsList conversations - POST
/api/v1/conversationsCreate conversation - GET
/api/v1/conversations/{id}Get conversation - POST
/api/v1/conversations/{id}Send message - DELETE
/api/v1/conversations/{id}Delete conversation - POST
/api/v1/conversations/{id}/tool-outputsAnswer pending questions - GET
/api/v1/conversations/{id}/streamGet stream - POST
/api/v1/conversations/{id}/abortAbort run - POST
/api/v1/conversations/{id}/clearClear conversation - POST
/api/v1/conversations/{id}/resetReset conversation
Attachments
Artifacts
System
The OpenAPI spec
The same description, as an OpenAPI 3.1 document, is public at
https://pulse.bilby.ai/api/v1/openapi. Point a client generator or an API tool such as Postman at
it.