{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/dialogbrain-com/json-schema/dialogbrain-com-voice-bridge-request-schema.json",
  "title": "VoiceBridgeRequest",
  "description": "Request to bridge an external LiveKit room to an agent.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/dialogbrain-com-calls-api-openapi.yml#/components/schemas/VoiceBridgeRequest",
  "properties": {
    "livekit_url": {
      "type": "string",
      "title": "Livekit Url",
      "description": "WebSocket URL of your LiveKit server, wss:// only. Private addresses are refused."
    },
    "room": {
      "type": "string",
      "title": "Room",
      "description": "Room name in the partner's LiveKit instance."
    },
    "token": {
      "type": "string",
      "title": "Token",
      "description": "LiveKit access token for joining the partner's room. Must be valid for at least 300 seconds (or answer_delay_s if longer)."
    },
    "agent_id": {
      "type": "integer",
      "title": "Agent Id",
      "description": "The DialogBrain agent to handle the call."
    },
    "caller_external_identity": {
      "type": "string",
      "title": "Caller External Identity",
      "description": "The caller's participant identity in your room. The bridge listens to this participant only, and its departure ends the call."
    },
    "owner_identity": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Owner Identity",
      "description": "The room owner's participant identity. Only meaningful with a non-zero answer_delay_s: this participant joining means the human answered, and the agent stands down unbilled."
    },
    "end_user_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "End User Id",
      "description": "Your identifier for the caller. Comes back on the call events inside metadata."
    },
    "answer_delay_s": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Answer Delay S",
      "description": "Seconds to ring the human before the agent answers (0-120). Absent or 0: agent answers immediately."
    },
    "metadata": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Metadata",
      "description": "Arbitrary JSON-serializable data. Returned on call events. Max 4 KB."
    }
  },
  "type": "object",
  "required": [
    "livekit_url",
    "room",
    "token",
    "agent_id",
    "caller_external_identity"
  ]
}