CreateAgentVersionRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amigo/main/json-schema/amigo-create-agent-version-request-schema.json",
  "title": "CreateAgentVersionRequest",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amigo-agents-api-openapi.yml#/components/schemas/CreateAgentVersionRequest",
  "properties": {
    "name": {
      "$ref": "#/$defs/NameString"
    },
    "initials": {
      "type": "string",
      "maxLength": 10,
      "title": "Initials",
      "default": ""
    },
    "identity": {
      "$ref": "#/$defs/Identity"
    },
    "voice_config": {
      "anyOf": [
        {
          "$ref": "#/$defs/VoiceConfig"
        },
        {
          "type": "null"
        }
      ]
    },
    "background": {
      "$ref": "#/$defs/BackgroundString",
      "default": ""
    },
    "behaviors": {
      "items": {
        "type": "string",
        "maxLength": 2000
      },
      "type": "array",
      "maxItems": 200,
      "title": "Behaviors"
    },
    "communication_patterns": {
      "items": {
        "type": "string",
        "maxLength": 2000
      },
      "type": "array",
      "maxItems": 200,
      "title": "Communication Patterns"
    }
  },
  "type": "object",
  "required": [
    "name",
    "identity"
  ],
  "$defs": {
    "BackgroundString": {
      "type": "string",
      "maxLength": 10000
    },
    "Identity": {
      "properties": {
        "name": {
          "type": "string",
          "title": "Name"
        },
        "role": {
          "type": "string",
          "title": "Role"
        },
        "developed_by": {
          "type": "string",
          "title": "Developed By"
        },
        "default_spoken_language": {
          "type": "string",
          "title": "Default Spoken Language"
        },
        "relationship_to_developer": {
          "$ref": "#/$defs/RelationshipToDeveloper"
        }
      },
      "type": "object",
      "required": [
        "name",
        "role",
        "developed_by",
        "default_spoken_language"
      ],
      "title": "Identity"
    },
    "LanguageProviderEntry": {
      "properties": {
        "provider": {
          "type": "string",
          "enum": [
            "cartesia",
            "elevenlabs",
            "groq"
          ],
          "title": "Provider"
        },
        "config": {
          "additionalProperties": true,
          "type": "object",
          "maxProperties": 20,
          "title": "Config"
        }
      },
      "type": "object",
      "required": [
        "provider"
      ],
      "title": "LanguageProviderEntry",
      "description": "Per-language TTS provider configuration."
    },
    "NameString": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1
    },
    "RelationshipToDeveloper": {
      "properties": {
        "ownership": {
          "type": "string",
          "title": "Ownership"
        },
        "type": {
          "type": "string",
          "title": "Type"
        },
        "conversation_visibility": {
          "type": "string",
          "title": "Conversation Visibility"
        },
        "thought_visibility": {
          "type": "string",
          "title": "Thought Visibility"
        }
      },
      "type": "object",
      "required": [
        "ownership",
        "type",
        "conversation_visibility",
        "thought_visibility"
      ],
      "title": "RelationshipToDeveloper"
    },
    "VoiceConfig": {
      "properties": {
        "voice_id": {
          "type": "string",
          "title": "Voice Id"
        },
        "stability": {
          "type": "number",
          "title": "Stability",
          "default": 0
        },
        "similarity_boost": {
          "type": "number",
          "title": "Similarity Boost",
          "default": 0
        },
        "style": {
          "type": "number",
          "title": "Style",
          "default": 0
        },
        "tts_provider": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "cartesia",
                "elevenlabs",
                "groq"
              ]
            },
            {
              "type": "null"
            }
          ],
          "title": "Tts Provider"
        },
        "tts_config": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Tts Config"
        },
        "language_providers": {
          "anyOf": [
            {
              "additionalProperties": {
                "$ref": "#/$defs/LanguageProviderEntry"
              },
              "type": "object",
              "maxProperties": 10
            },
            {
              "type": "null"
            }
          ],
          "title": "Language Providers"
        },
        "session_provider": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "amigo",
                "gpt_realtime",
                "gpt_live"
              ]
            },
            {
              "type": "null"
            }
          ],
          "title": "Session Provider"
        }
      },
      "type": "object",
      "required": [
        "voice_id"
      ],
      "title": "VoiceConfig"
    }
  }
}