{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/conduyt-com/json-schema/conduyt-com-dialer-call-recording-schema.json",
  "title": "DialerCallRecording",
  "description": "One recording of a call (#419). Play it through `mediaUrl` (the authenticated media proxy; add `&download=1` to download).",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/conduyt-com-calls-api-openapi.yml#/components/schemas/DialerCallRecording",
  "type": "object",
  "required": [
    "sid",
    "part",
    "startedAt",
    "durationSeconds",
    "primary",
    "mediaUrl"
  ],
  "properties": {
    "sid": {
      "type": [
        "string",
        "null"
      ],
      "description": "The Twilio RecordingSid; null only on a call recorded before the sid was kept."
    },
    "part": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "bridge",
        "conference",
        null
      ],
      "description": "bridge: before the conference; conference: the conference; null: the call was never upgraded into a conference."
    },
    "startedAt": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "durationSeconds": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Seconds, when known; null otherwise."
    },
    "primary": {
      "type": "boolean",
      "description": "The call's own recording (the one transcribed)."
    },
    "mediaUrl": {
      "type": "string",
      "description": "GET /api/v1/dialer/call/{id}/media?type=recording[&sid=...]"
    }
  }
}