{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/bandwidth/main/json-schema/bandwidth-update-call-request-schema.json",
  "title": "UpdateCallRequest",
  "x-generated": "2026-10-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/bandwidth-calls-api-openapi.yml#/components/schemas/UpdateCallRequest",
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "enum": [
        "active",
        "completed"
      ],
      "description": "Set to completed to hang up the call"
    },
    "redirectUrl": {
      "type": "string",
      "format": "uri",
      "description": "The URL to redirect the call to for new BXML instructions"
    },
    "redirectMethod": {
      "type": "string",
      "enum": [
        "POST",
        "GET"
      ],
      "default": "POST",
      "description": "The HTTP method for the redirect webhook"
    },
    "redirectFallbackUrl": {
      "type": "string",
      "format": "uri",
      "description": "Fallback URL if the primary redirect URL fails"
    },
    "redirectFallbackMethod": {
      "type": "string",
      "enum": [
        "POST",
        "GET"
      ],
      "default": "POST",
      "description": "The HTTP method for the fallback redirect webhook"
    },
    "tag": {
      "type": "string",
      "maxLength": 256,
      "description": "A custom string to attach to the call for tracking purposes"
    }
  }
}