API Reference

    Complete reference for all OneBudd API endpoints.

    Base URL

    https://api.onebudd.com/v1

    Authentication

    All requests require an API key passed in the Authorization header:

    Authentication Header
    Authorization: Bearer YOUR_API_KEY

    See Authentication for details.

    Conversations

    POST/conversationsCreate a new conversation
    GET/conversations/:idGet conversation details
    POST/conversations/:id/processProcess audio input
    DELETE/conversations/:idEnd a conversation

    Speech-to-Text

    POST/stt/transcribeTranscribe audio file
    POST/stt/streamStart streaming transcription

    Text-to-Speech

    POST/tts/synthesizeSynthesize speech from text
    GET/tts/voicesList available voices

    Memory

    GET/memory/:userIdGet user memories
    POST/memoryStore a memory
    DELETE/memory/:idDelete a memory

    Profiles

    POST/profilesCreate a user profile
    GET/profiles/:idGet profile details
    PATCH/profiles/:idUpdate a profile

    Response Codes

    2xx Success

    • 200 - Request succeeded
    • 201 - Resource created
    • 204 - No content (deleted)

    4xx/5xx Errors

    • 400 - Bad request
    • 401 - Unauthorized
    • 429 - Rate limited
    • 500 - Server error
    Error HandlingSDK Guides