{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentline-cloud/json-schema/agentline-cloud-agent-update-schema.json",
  "title": "AgentUpdate",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentline-cloud-openapi.json#/components/schemas/AgentUpdate",
  "properties": {
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Name",
      "description": "New display name for the AI voice agent"
    },
    "system_prompt": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "System Prompt",
      "description": "Updated default instructions for ALL future calls (does not affect calls already in progress)"
    },
    "initial_greeting": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Initial Greeting",
      "description": "Updated default greeting for ALL future calls (inbound and outbound)"
    },
    "voice_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Voice Id",
      "description": "New voice: a voice_id from list_available_voices or a legacy preset name"
    },
    "speech_language": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Speech Language",
      "description": "BCP-47 locale the agent listens and speaks in, e.g. 'en-US', 'hi-IN'. 'auto' (or unset) keeps multilingual auto-detection. Allowed values are listed under 'languages' by list_available_voices. Send null to go back to auto-detection."
    },
    "speaking_speed": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 1.5,
          "minimum": 0.6
        },
        {
          "type": "null"
        }
      ],
      "title": "Speaking Speed",
      "description": "Speaking pace multiplier from 0.6 (slower) to 1.5 (faster); 1.0 is the voice's natural pace. Send null to go back to 1.0."
    },
    "transfer_number": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Transfer Number",
      "description": "Number a live call is transferred to. Only the owner phone is allowed, so send the same E.164 number as owner_phone (current or in this request); setting owner_phone updates it automatically."
    },
    "voicemail_message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Voicemail Message",
      "description": "Updated voicemail message"
    },
    "owner_phone": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Owner Phone",
      "description": "Updated owner phone in E.164. Also becomes the only live-call transfer destination."
    }
  },
  "additionalProperties": false,
  "type": "object"
}