{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/auxen-ai/json-schema/auxen-ai-deployment-schema.json",
  "title": "Deployment",
  "x-generated": "2026-11-02",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/auxen-ai-openapi.json#/components/schemas/Deployment",
  "type": "object",
  "properties": {
    "deployment_id": {
      "type": "string"
    },
    "instance_id": {
      "type": "string",
      "deprecated": true,
      "description": "Deprecated alias of `deployment_id`; returned until 2027-04-02."
    },
    "status": {
      "enum": [
        "deploying",
        "ready",
        "paused",
        "warming",
        "switching",
        "suspended",
        "error",
        "deleted"
      ],
      "description": "On /v1/deployments/* routes. (Deprecated routes return the pre-2026 value here and the new one in `deployment_status`.)"
    },
    "legacy_status": {
      "type": "string",
      "description": "Pre-2026 status value (e.g. `running` for `ready`); returned until 2027-04-02."
    },
    "model": {
      "type": "string"
    },
    "billing": {
      "enum": [
        "subscription",
        "pay_as_you_go",
        "on_demand"
      ],
      "description": "Current billing mode. `pay_as_you_go` is canonical; `on_demand` is a back-compat alias; `subscription` is legacy and applies only to grandfathered accounts."
    },
    "label": {
      "type": [
        "string",
        "null"
      ]
    },
    "endpoint": {
      "type": [
        "string",
        "null"
      ],
      "description": "Inference endpoint. OpenAI-compatible base URL is `{endpoint}/v1`."
    },
    "api_key": {
      "type": [
        "string",
        "null"
      ],
      "description": "Per-deployment inference key. Use this in Authorization for /chat and /v1/chat/completions."
    },
    "webhook_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "throughput": {
      "enum": [
        "standard",
        "double",
        "quad",
        "max"
      ]
    },
    "throughput_multiplier": {
      "type": "integer",
      "enum": [
        1,
        2,
        4,
        8
      ]
    },
    "capacity": {
      "type": "integer",
      "enum": [
        1,
        2,
        4,
        8
      ],
      "deprecated": true,
      "description": "Deprecated alias of `throughput_multiplier`; returned until 2027-04-02."
    },
    "system_prompt": {
      "type": [
        "string",
        "null"
      ],
      "description": "Per-deployment system prompt. null = inherit account default."
    },
    "billing_details": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "mode": {
              "const": "subscription"
            },
            "plan": {
              "enum": [
                "shared",
                "dedicated",
                "business",
                "enterprise"
              ]
            },
            "monthly_cost": {
              "type": "number"
            },
            "next_billing_date": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        {
          "type": "object",
          "properties": {
            "mode": {
              "const": "pay_as_you_go"
            },
            "rate_per_hour": {
              "type": "string"
            },
            "hourly_rate": {
              "type": "number",
              "deprecated": true,
              "description": "Deprecated alias of `rate_per_hour`; returned until 2027-04-02."
            },
            "accumulated_cost": {
              "type": "number"
            },
            "spending_cap": {
              "type": [
                "number",
                "null"
              ]
            },
            "paused_at": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          }
        }
      ]
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "ready_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "deleted_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "destroyed_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "deprecated": true,
      "description": "Deprecated alias of `deleted_at`; returned until 2027-04-02."
    }
  }
}