BlogRegister

    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