{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/ringover/json-schema/ringover-request-callback-schema.json",
  "title": "request_callback",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ringover-callbacks-api-openapi.yml#/components/schemas/request_callback",
  "type": "object",
  "required": [
    "to_number",
    "device"
  ],
  "properties": {
    "from_number": {
      "type": [
        "integer",
        "null"
      ],
      "description": "The team member's phone number to initiate the callback from (E.164 format, digits only).\nRequires **Monitoring ON**. When Monitoring is OFF or when omitted, the authenticated user's default number is used.\n",
      "format": "int64"
    },
    "to_number": {
      "type": "integer",
      "format": "int64",
      "description": "Destination phone number in E.164 format (digits only). Required."
    },
    "timeout": {
      "type": "integer",
      "format": "int64",
      "minimum": 10,
      "maximum": 300,
      "default": 20,
      "description": "Number of seconds to wait before aborting the call if the communication is not established. Min: 10, max: 300, default: 20."
    },
    "device": {
      "type": "string",
      "enum": [
        "ALL",
        "APP",
        "WEB",
        "SIP",
        "MOB",
        "EXT"
      ],
      "description": "Device to ring for the callback. Required. Use a 3-character code: APP (mobile app), WEB (web app), SIP (SIP phone), MOB (mobile number), EXT (external number), ALL (all devices)."
    },
    "clir": {
      "type": "boolean",
      "default": false,
      "description": "Calling Line Identification Restriction. When true, the caller's number is hidden from the recipient."
    }
  }
}