{
  "components": {
    "schemas": {
      "AcceptInvitationRequest": {
        "properties": {
          "invitation_id": {
            "type": "string"
          },
          "token": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "AcceptInvitationRequest"
      },
      "AccountBalanceResponse": {
        "properties": {
          "account_id": {
            "type": "string"
          },
          "balance": {
            "type": "number"
          }
        },
        "type": "object",
        "x-go-name": "AccountBalanceResponse"
      },
      "AccountListResponse": {
        "properties": {
          "memberships": {
            "items": {
              "$ref": "#/components/schemas/AccountMembershipResponse"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "AccountListResponse"
      },
      "AccountMemberListResponse": {
        "properties": {
          "members": {
            "items": {
              "$ref": "#/components/schemas/AccountMemberResponse"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "AccountMemberListResponse"
      },
      "AccountMemberResponse": {
        "properties": {
          "account_id": {
            "type": "string"
          },
          "created_at_unix": {
            "type": "integer"
          },
          "email": {
            "type": "string"
          },
          "role": {
            "type": "string"
          },
          "user_id": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "AccountMemberResponse"
      },
      "AccountMembershipResponse": {
        "properties": {
          "account": {
            "$ref": "#/components/schemas/AccountResponse"
          },
          "account_id": {
            "type": "string"
          },
          "created_at_unix": {
            "type": "integer"
          },
          "role": {
            "type": "string"
          },
          "user_id": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "AccountMembershipResponse"
      },
      "AccountResponse": {
        "properties": {
          "created_at_unix": {
            "type": "integer"
          },
          "description": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "AccountResponse"
      },
      "AddAccountMemberRequest": {
        "properties": {
          "email": {
            "type": "string"
          },
          "role": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "AddAccountMemberRequest"
      },
      "ApiKeyListResponse": {
        "properties": {
          "api_keys": {
            "items": {
              "$ref": "#/components/schemas/ApiKeyResponse"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "ApiKeyListResponse"
      },
      "ApiKeyResponse": {
        "properties": {
          "created_at": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "key_prefix": {
            "type": "string"
          },
          "plaintext_key": {
            "type": "string"
          },
          "revoked_at": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ApiKeyResponse"
      },
      "AudioSpeechRequest": {
        "properties": {
          "input": {
            "type": "string"
          },
          "instructions": {
            "type": "string"
          },
          "language": {
            "type": "string"
          },
          "max_new_tokens": {
            "type": "integer"
          },
          "model": {
            "type": "string"
          },
          "ref_audio": {
            "type": "string"
          },
          "ref_text": {
            "type": "string"
          },
          "response_format": {
            "type": "string"
          },
          "seed": {
            "type": "integer"
          },
          "speed": {
            "type": "number"
          },
          "task_type": {
            "type": "string"
          },
          "voice": {
            "type": "string"
          },
          "x_vector_only_mode": {
            "type": "boolean"
          }
        },
        "type": "object",
        "x-go-name": "AudioSpeechRequest"
      },
      "BeginPasskeyRegistrationResponse": {
        "properties": {
          "challenge_id": {
            "type": "string"
          },
          "public_key": {
            "items": {
              "type": "integer"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "BeginPasskeyRegistrationResponse"
      },
      "BeginPasskeyloginRequest": {
        "properties": {
          "cf_turnstile_response": {
            "type": "string"
          },
          "email": {
            "type": "string"
          }
        },
        "required": [
          "email"
        ],
        "type": "object",
        "x-go-name": "BeginPasskeyloginRequest"
      },
      "BeginPasskeyloginResponse": {
        "properties": {
          "challenge_id": {
            "type": "string"
          },
          "public_key": {
            "items": {
              "type": "integer"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "BeginPasskeyloginResponse"
      },
      "BeginTotpEnrollmentResponse": {
        "properties": {
          "otpauth_uri": {
            "type": "string"
          },
          "secret": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "BeginTotpEnrollmentResponse"
      },
      "BiomolecularCapabilities": {
        "properties": {
          "checked_at": {
            "type": "string"
          },
          "msa_status": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "BiomolecularCapabilities"
      },
      "CatalogGPUResponse": {
        "properties": {
          "availability_count": {
            "type": "integer"
          },
          "availability_total": {
            "type": "integer"
          },
          "capacity_tier": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "compute_tflops": {
            "type": "number"
          },
          "continent": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "cpu_cores": {
            "type": "integer"
          },
          "cpu_name": {
            "type": "string"
          },
          "cpu_ram_gb": {
            "type": "integer"
          },
          "cuda_max_good": {
            "type": "number"
          },
          "disk_bandwidth_mbps": {
            "type": "number"
          },
          "display_name": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "gpu_count": {
            "type": "integer"
          },
          "internet_down_mbps": {
            "type": "number"
          },
          "internet_up_mbps": {
            "type": "number"
          },
          "market_type": {
            "type": "string"
          },
          "price_per_hour_eur": {
            "type": "number"
          },
          "provider_codename": {
            "type": "string"
          },
          "public_gpu_id": {
            "type": "string"
          },
          "reliability": {
            "type": "number"
          },
          "stock_status": {
            "type": "string"
          },
          "vram_gb": {
            "type": "number"
          }
        },
        "type": "object",
        "x-go-name": "CatalogGPUResponse"
      },
      "ChangePasswordRequest": {
        "properties": {
          "current_password": {
            "type": "string"
          },
          "new_password": {
            "minLength": 8,
            "type": "string"
          }
        },
        "required": [
          "current_password",
          "new_password"
        ],
        "type": "object",
        "x-go-name": "ChangePasswordRequest"
      },
      "ChatMessageEnvelope": {
        "properties": {
          "content": {
            "items": {
              "type": "integer"
            },
            "type": "array"
          },
          "reasoning": {
            "type": "string"
          },
          "reasoning_content": {
            "type": "string"
          },
          "role": {
            "type": "string"
          },
          "tool_call_id": {
            "type": "string"
          },
          "tool_calls": {
            "items": {
              "$ref": "#/components/schemas/ChatToolCallEnvelope"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "ChatMessageEnvelope"
      },
      "ChatRequestEnvelope": {
        "properties": {
          "firewall": {
            "type": "string"
          },
          "max_tokens": {
            "type": "integer"
          },
          "messages": {
            "items": {
              "$ref": "#/components/schemas/ChatMessageEnvelope"
            },
            "type": "array"
          },
          "modalities": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "model": {
            "type": "string"
          },
          "speaker": {
            "type": "string"
          },
          "stream": {
            "type": "boolean"
          },
          "temperature": {
            "type": "number"
          },
          "top_p": {
            "type": "number"
          }
        },
        "type": "object",
        "x-go-name": "ChatRequestEnvelope"
      },
      "ChatToolCallEnvelope": {
        "properties": {
          "function": {
            "$ref": "#/components/schemas/ChatToolCallFunctionEnvelope"
          },
          "id": {
            "type": "string"
          },
          "index": {
            "type": "integer"
          },
          "type": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ChatToolCallEnvelope"
      },
      "ChatToolCallFunctionEnvelope": {
        "properties": {
          "arguments": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ChatToolCallFunctionEnvelope"
      },
      "CheckoutSessionResponse": {
        "properties": {
          "checkout_url": {
            "type": "string"
          },
          "session_id": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "CheckoutSessionResponse"
      },
      "ConfirmTotpEnrollmentRequest": {
        "properties": {
          "code": {
            "type": "string"
          },
          "secret": {
            "type": "string"
          }
        },
        "required": [
          "code",
          "secret"
        ],
        "type": "object",
        "x-go-name": "ConfirmTotpEnrollmentRequest"
      },
      "CreateAccountRequest": {
        "properties": {
          "name": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "CreateAccountRequest"
      },
      "CreateCheckoutSessionRequest": {
        "properties": {
          "amount_cents": {
            "type": "number"
          },
          "cancel_url": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "discount_code": {
            "type": "string"
          },
          "success_url": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "CreateCheckoutSessionRequest"
      },
      "CreateFirewallRequest": {
        "properties": {
          "description": {
            "type": "string"
          },
          "evaluator_serving_name": {
            "type": "string"
          },
          "mode": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "rule_slugs": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "slug": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "CreateFirewallRequest"
      },
      "CreateFirewallRuleRequest": {
        "properties": {
          "category": {
            "type": "string"
          },
          "default_severity": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "prompt": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "CreateFirewallRuleRequest"
      },
      "CreateInstanceRequest": {
        "properties": {
          "description": {
            "type": "string"
          },
          "download_size_bytes": {
            "type": "integer"
          },
          "gguf_model_path": {
            "type": "string"
          },
          "gpu_preferences": {
            "items": {
              "$ref": "#/components/schemas/PublicGPUPreferenceJSON"
            },
            "type": "array"
          },
          "huggingface_repo_id": {
            "type": "string"
          },
          "idle_timeout_seconds": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "replica_count": {
            "type": "integer"
          },
          "runtime_config": {
            "$ref": "#/components/schemas/RuntimeConfigRequest"
          },
          "runtime_preset": {
            "type": "string"
          },
          "scheduling_mode": {
            "type": "string"
          },
          "serverless_enabled": {
            "type": "boolean"
          },
          "serving_name": {
            "type": "string"
          },
          "smart_allow_community": {
            "type": "boolean"
          },
          "smart_allow_spot": {
            "type": "boolean"
          },
          "smart_max_price_per_hour_eur": {
            "type": "number"
          },
          "smart_min_gpu_class": {
            "type": "string"
          },
          "smart_min_total_tflops": {
            "type": "number"
          },
          "smart_provider_filter_mode": {
            "type": "string"
          },
          "smart_provider_preference": {
            "type": "string"
          },
          "smart_region": {
            "type": "string"
          },
          "smart_regions": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "smart_selection_label": {
            "type": "string"
          },
          "supported_protocols": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "CreateInstanceRequest"
      },
      "CreateInvitationRequest": {
        "properties": {
          "email": {
            "type": "string"
          },
          "role": {
            "type": "string"
          }
        },
        "required": [
          "email",
          "role"
        ],
        "type": "object",
        "x-go-name": "CreateInvitationRequest"
      },
      "CreateServingEndpointRequest": {
        "properties": {
          "display_name": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "target": {
            "$ref": "#/components/schemas/ServingTargetRequest"
          },
          "workload_kind": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "CreateServingEndpointRequest"
      },
      "CreateSmartBalancerRequest": {
        "properties": {
          "display_name": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "router_model": {
            "$ref": "#/components/schemas/SmartBalancerRouterModelRequest"
          },
          "routes": {
            "items": {
              "$ref": "#/components/schemas/SmartBalancerRouteRequest"
            },
            "type": "array"
          },
          "routing_mode": {
            "type": "string"
          },
          "serverless_start_requests": {
            "default": 1,
            "description": "Requests in the rolling window required before starting stopped serverless destinations.",
            "maximum": 10000,
            "minimum": 1,
            "type": "integer"
          },
          "serverless_start_window_seconds": {
            "default": 60,
            "description": "Rolling request window in seconds.",
            "maximum": 86400,
            "minimum": 1,
            "type": "integer"
          },
          "workload_kind": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "CreateSmartBalancerRequest"
      },
      "CreateTargetGroupRequest": {
        "properties": {
          "description": {
            "type": "string"
          },
          "display_name": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "members": {
            "items": {
              "$ref": "#/components/schemas/TargetGroupMemberRequest"
            },
            "type": "array"
          },
          "name": {
            "type": "string"
          },
          "selection_policy": {
            "type": "string"
          },
          "workload_kind": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "CreateTargetGroupRequest"
      },
      "CreateVectorDatabaseRequest": {
        "properties": {
          "description": {
            "type": "string"
          },
          "embedding_serving_name": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "CreateVectorDatabaseRequest"
      },
      "DebitBalanceRequest": {
        "properties": {
          "amount_cents": {
            "type": "number"
          },
          "reference": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "DebitBalanceRequest"
      },
      "DebitBalanceResponse": {
        "properties": {
          "new_balance": {
            "type": "number"
          },
          "success": {
            "type": "boolean"
          }
        },
        "type": "object",
        "x-go-name": "DebitBalanceResponse"
      },
      "DebitOperationResponse": {
        "properties": {
          "created_at": {
            "type": "string"
          },
          "operation_id": {
            "type": "string"
          },
          "outcome": {
            "type": "string"
          },
          "reference": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "DebitOperationResponse"
      },
      "DetectionStreamError": {
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "DetectionStreamError"
      },
      "DetectionStreamEvent": {
        "properties": {
          "error": {
            "$ref": "#/components/schemas/DetectionStreamError"
          },
          "frame_id": {
            "type": "integer"
          },
          "max_frame_bytes": {
            "type": "integer"
          },
          "model": {
            "type": "string"
          },
          "options": {
            "$ref": "#/components/schemas/DetectionStreamOptions"
          },
          "processing_ms": {
            "type": "number"
          },
          "result": {
            "$ref": "#/components/schemas/ImageDetectionOutput"
          },
          "status": {
            "type": "integer"
          },
          "type": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "DetectionStreamEvent"
      },
      "DetectionStreamOptions": {
        "properties": {
          "classes": {
            "items": {
              "type": "integer"
            },
            "type": "array"
          },
          "confidence": {
            "type": "number"
          },
          "image_size": {
            "type": "integer"
          },
          "iou": {
            "type": "number"
          },
          "max_detections": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "DetectionStreamOptions"
      },
      "DismissRequest": {
        "properties": {
          "ids": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "DismissRequest"
      },
      "DismissResponse": {
        "properties": {
          "dismissed": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "DismissResponse"
      },
      "EmbeddingsRequestEnvelope": {
        "properties": {
          "input": {
            "items": {
              "type": "integer"
            },
            "type": "array"
          },
          "model": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "EmbeddingsRequestEnvelope"
      },
      "EnableSharedCapacityRequest": {
        "properties": {
          "terms_hash": {
            "type": "string"
          },
          "terms_version": {
            "type": "string"
          },
          "visibility": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "EnableSharedCapacityRequest"
      },
      "ErrorResponse": {
        "properties": {
          "error": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ErrorResponse"
      },
      "Execution.ForecastInput": {
        "properties": {
          "id": {
            "type": "string"
          },
          "past_future_covariates": {
            "items": {
              "items": {
                "format": "float64",
                "type": "number"
              },
              "type": "array"
            },
            "type": "array"
          },
          "past_only_covariates": {
            "items": {
              "items": {
                "format": "float64",
                "type": "number"
              },
              "type": "array"
            },
            "type": "array"
          },
          "target": {
            "items": {
              "items": {
                "format": "float64",
                "type": "number"
              },
              "type": "array"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "Execution.ForecastInput"
      },
      "Execution.ForecastPrediction": {
        "properties": {
          "forecast": {
            "items": {
              "items": {
                "format": "float64",
                "type": "number"
              },
              "type": "array"
            },
            "type": "array"
          },
          "id": {
            "type": "string"
          },
          "quantiles": {
            "items": {
              "items": {
                "items": {
                  "format": "float64",
                  "type": "number"
                },
                "type": "array"
              },
              "type": "array"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "Execution.ForecastPrediction"
      },
      "Execution.ForecastRequest": {
        "properties": {
          "horizon": {
            "maximum": 1024,
            "minimum": 1,
            "type": "integer"
          },
          "inputs": {
            "items": {
              "$ref": "#/components/schemas/Execution.ForecastInput"
            },
            "type": "array"
          },
          "model": {
            "type": "string"
          },
          "return_quantiles": {
            "type": "boolean"
          },
          "use_symmetric_averaging": {
            "type": "boolean"
          }
        },
        "required": [
          "horizon",
          "inputs",
          "model"
        ],
        "type": "object",
        "x-go-name": "Execution.ForecastRequest"
      },
      "Execution.ForecastResponse": {
        "properties": {
          "horizon": {
            "type": "integer"
          },
          "model": {
            "type": "string"
          },
          "predictions": {
            "items": {
              "$ref": "#/components/schemas/Execution.ForecastPrediction"
            },
            "type": "array"
          },
          "quantile_levels": {
            "items": {
              "type": "number"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "Execution.ForecastResponse"
      },
      "FinishPasskeyRegistrationRequest": {
        "properties": {
          "challenge_id": {
            "type": "string"
          },
          "credential": {
            "items": {
              "type": "integer"
            },
            "type": "array"
          }
        },
        "required": [
          "challenge_id",
          "credential"
        ],
        "type": "object",
        "x-go-name": "FinishPasskeyRegistrationRequest"
      },
      "FinishPasskeyloginRequest": {
        "properties": {
          "cf_turnstile_response": {
            "type": "string"
          },
          "challenge_id": {
            "type": "string"
          },
          "credential": {
            "items": {
              "type": "integer"
            },
            "type": "array"
          },
          "email": {
            "type": "string"
          }
        },
        "required": [
          "challenge_id",
          "credential",
          "email"
        ],
        "type": "object",
        "x-go-name": "FinishPasskeyloginRequest"
      },
      "FinishPasskeyloginResponse": {
        "type": "object",
        "x-go-name": "FinishPasskeyloginResponse"
      },
      "FirewallEvaluationRequest": {
        "properties": {
          "input": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "FirewallEvaluationRequest"
      },
      "FirewallEvaluationResponse": {
        "properties": {
          "allowed": {
            "type": "boolean"
          },
          "evaluator_serving_name": {
            "type": "string"
          },
          "firewall_slug": {
            "type": "string"
          },
          "matched_rules": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "mode": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "severity": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "FirewallEvaluationResponse"
      },
      "FirewallResponse": {
        "properties": {
          "created_at": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "evaluator_serving_name": {
            "type": "string"
          },
          "mode": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "rule_slugs": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "slug": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "FirewallResponse"
      },
      "FirewallRuleEvaluationRequest": {
        "properties": {
          "evaluator_serving_name": {
            "type": "string"
          },
          "input": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "FirewallRuleEvaluationRequest"
      },
      "FirewallRuleResponse": {
        "properties": {
          "category": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "default_severity": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "prompt": {
            "type": "string"
          },
          "recommended": {
            "type": "boolean"
          },
          "slug": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "FirewallRuleResponse"
      },
      "ForgotPasswordRequest": {
        "properties": {
          "cf_turnstile_response": {
            "type": "string"
          },
          "email": {
            "type": "string"
          }
        },
        "required": [
          "email"
        ],
        "type": "object",
        "x-go-name": "ForgotPasswordRequest"
      },
      "ForgotPasswordResponse": {
        "properties": {
          "message": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ForgotPasswordResponse"
      },
      "GetTemplateBySlugResponse": {
        "properties": {
          "template": {
            "$ref": "#/components/schemas/TemplateWithVariants"
          }
        },
        "type": "object",
        "x-go-name": "GetTemplateBySlugResponse"
      },
      "GetUserVariantResponse": {
        "properties": {
          "variant": {
            "$ref": "#/components/schemas/VariantWithRelations"
          }
        },
        "type": "object",
        "x-go-name": "GetUserVariantResponse"
      },
      "GpuListResponse": {
        "properties": {
          "gpus": {
            "items": {
              "$ref": "#/components/schemas/CatalogGPUResponse"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "GpuListResponse"
      },
      "GpuPreferenceResponse": {
        "properties": {
          "count": {
            "type": "integer"
          },
          "provider_codename": {
            "type": "string"
          },
          "public_gpu_id": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "GpuPreferenceResponse"
      },
      "HttpTarget": {
        "properties": {
          "labels": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object"
          },
          "targets": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "HttpTarget"
      },
      "HuggingFaceFileResponse": {
        "properties": {
          "filename": {
            "type": "string"
          },
          "quantization": {
            "type": "string"
          },
          "size_bytes": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "HuggingFaceFileResponse"
      },
      "HuggingFaceFilesResponse": {
        "properties": {
          "files": {
            "items": {
              "$ref": "#/components/schemas/HuggingFaceFileResponse"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "HuggingFaceFilesResponse"
      },
      "HuggingFaceGGUFFileResponse": {
        "properties": {
          "filename": {
            "type": "string"
          },
          "quantization": {
            "type": "string"
          },
          "size_bytes": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "HuggingFaceGGUFFileResponse"
      },
      "HuggingFaceModelResponse": {
        "properties": {
          "compatibility_reason": {
            "type": "string"
          },
          "compatible": {
            "type": "boolean"
          },
          "description": {
            "type": "string"
          },
          "downloads": {
            "type": "integer"
          },
          "gguf_files": {
            "items": {
              "$ref": "#/components/schemas/HuggingFaceGGUFFileResponse"
            },
            "type": "array"
          },
          "has_gguf": {
            "type": "boolean"
          },
          "has_safetensors": {
            "type": "boolean"
          },
          "last_modified": {
            "type": "string"
          },
          "likes": {
            "type": "integer"
          },
          "pipeline_tag": {
            "type": "string"
          },
          "repo_id": {
            "type": "string"
          },
          "siblings": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "warnings": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "workload_kind": {
            "type": "string"
          },
          "yolo_files": {
            "items": {
              "$ref": "#/components/schemas/HuggingFaceYOLOFileResponse"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "HuggingFaceModelResponse"
      },
      "HuggingFaceModelsResponse": {
        "properties": {
          "models": {
            "items": {
              "$ref": "#/components/schemas/HuggingFaceModelResponse"
            },
            "type": "array"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "HuggingFaceModelsResponse"
      },
      "HuggingFaceOrgInfoResponse": {
        "properties": {
          "avatar_url": {
            "type": "string"
          },
          "fullname": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "HuggingFaceOrgInfoResponse"
      },
      "HuggingFaceYOLOFileResponse": {
        "properties": {
          "filename": {
            "type": "string"
          },
          "size_bytes": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "HuggingFaceYOLOFileResponse"
      },
      "ImageDetectionBoxOutput": {
        "properties": {
          "x1": {
            "type": "number"
          },
          "x2": {
            "type": "number"
          },
          "y1": {
            "type": "number"
          },
          "y2": {
            "type": "number"
          }
        },
        "type": "object",
        "x-go-name": "ImageDetectionBoxOutput"
      },
      "ImageDetectionKeypointOutput": {
        "properties": {
          "confidence": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          }
        },
        "type": "object",
        "x-go-name": "ImageDetectionKeypointOutput"
      },
      "ImageDetectionOutput": {
        "properties": {
          "detections": {
            "items": {
              "$ref": "#/components/schemas/ImageDetectionResultOutput"
            },
            "type": "array"
          },
          "height": {
            "type": "integer"
          },
          "model": {
            "type": "string"
          },
          "width": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "ImageDetectionOutput"
      },
      "ImageDetectionResultOutput": {
        "properties": {
          "box": {
            "$ref": "#/components/schemas/ImageDetectionBoxOutput"
          },
          "class_id": {
            "type": "integer"
          },
          "class_name": {
            "type": "string"
          },
          "confidence": {
            "type": "number"
          },
          "keypoints": {
            "items": {
              "$ref": "#/components/schemas/ImageDetectionKeypointOutput"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "ImageDetectionResultOutput"
      },
      "ImageGenerationRequest": {
        "properties": {
          "guidance_scale": {
            "type": "number"
          },
          "height": {
            "type": "integer"
          },
          "model": {
            "type": "string"
          },
          "n": {
            "type": "integer"
          },
          "num_inference_steps": {
            "type": "integer"
          },
          "prompt": {
            "type": "string"
          },
          "quality": {
            "type": "string"
          },
          "response_format": {
            "type": "string"
          },
          "seed": {
            "type": "integer"
          },
          "size": {
            "type": "string"
          },
          "style": {
            "type": "string"
          },
          "user": {
            "type": "string"
          },
          "width": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "ImageGenerationRequest"
      },
      "ImpersonationInfo": {
        "properties": {
          "impersonator_email": {
            "type": "string"
          },
          "impersonator_user_id": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ImpersonationInfo"
      },
      "IndexDocumentRequest": {
        "properties": {
          "content": {
            "type": "string"
          },
          "content_image_url": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object"
          },
          "source": {
            "$ref": "#/components/schemas/IndexDocumentSourceRequest"
          }
        },
        "type": "object",
        "x-go-name": "IndexDocumentRequest"
      },
      "IndexDocumentSourceRequest": {
        "properties": {
          "image_url": {
            "type": "string"
          },
          "text": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "IndexDocumentSourceRequest"
      },
      "IndexDocumentsRequest": {
        "properties": {
          "documents": {
            "items": {
              "$ref": "#/components/schemas/IndexDocumentRequest"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "IndexDocumentsRequest"
      },
      "IndexJobResponse": {
        "properties": {
          "account_id": {
            "type": "string"
          },
          "completed_at": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "database_id": {
            "type": "string"
          },
          "error_message": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "IndexJobResponse"
      },
      "InstanceListResponse": {
        "properties": {
          "instances": {
            "items": {
              "$ref": "#/components/schemas/InstanceResponse"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "InstanceListResponse"
      },
      "InstanceResponse": {
        "properties": {
          "account_id": {
            "type": "string"
          },
          "capacity_tier": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "estimated_required_vram_gb": {
            "type": "number"
          },
          "failure_reason": {
            "type": "string"
          },
          "gpu_count": {
            "type": "integer"
          },
          "gpu_preferences": {
            "items": {
              "$ref": "#/components/schemas/GpuPreferenceResponse"
            },
            "type": "array"
          },
          "huggingface_repo_id": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "idle_timeout_seconds": {
            "type": "integer"
          },
          "last_request_at": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "public_gpu_id": {
            "type": "string"
          },
          "public_price_per_hour_eur": {
            "type": "number"
          },
          "replica_set_id": {
            "type": "string"
          },
          "runtime_config_snapshot": {
            "type": "string"
          },
          "runtime_preset": {
            "type": "string"
          },
          "scheduling_mode": {
            "type": "string"
          },
          "serverless_enabled": {
            "type": "boolean"
          },
          "serving_name": {
            "type": "string"
          },
          "smart_allow_community": {
            "type": "boolean"
          },
          "smart_allow_spot": {
            "type": "boolean"
          },
          "smart_max_price_per_hour_eur": {
            "type": "number"
          },
          "smart_min_gpu_class": {
            "type": "string"
          },
          "smart_min_total_tflops": {
            "type": "number"
          },
          "smart_provider_filter_mode": {
            "type": "string"
          },
          "smart_provider_preference": {
            "type": "string"
          },
          "smart_region": {
            "type": "string"
          },
          "smart_regions": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "smart_selection_label": {
            "type": "string"
          },
          "started_at": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "stopped_at": {
            "type": "string"
          },
          "storage_price_per_hour_eur": {
            "type": "number"
          },
          "supported_protocols": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "workload_kind": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "InstanceResponse"
      },
      "InstanceUsageBucketResponse": {
        "properties": {
          "billable_seconds": {
            "type": "integer"
          },
          "cost_eur": {
            "type": "number"
          },
          "end_at": {
            "type": "string"
          },
          "start_at": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "InstanceUsageBucketResponse"
      },
      "InstanceUsageResponse": {
        "properties": {
          "bucket_unit": {
            "type": "string"
          },
          "range": {
            "type": "string"
          },
          "resource_metrics": {
            "$ref": "#/components/schemas/ResourceMetricsResponse"
          },
          "series": {
            "items": {
              "$ref": "#/components/schemas/InstanceUsageBucketResponse"
            },
            "type": "array"
          },
          "summary": {
            "$ref": "#/components/schemas/InstanceUsageSummaryResponse"
          }
        },
        "type": "object",
        "x-go-name": "InstanceUsageResponse"
      },
      "InstanceUsageSummaryResponse": {
        "properties": {
          "month_billable_seconds": {
            "type": "integer"
          },
          "month_daily_average_cost_eur": {
            "type": "number"
          },
          "month_total_cost_eur": {
            "type": "number"
          }
        },
        "type": "object",
        "x-go-name": "InstanceUsageSummaryResponse"
      },
      "InvitationListResponse": {
        "properties": {
          "invitations": {
            "items": {
              "$ref": "#/components/schemas/InvitationResponse"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "InvitationListResponse"
      },
      "InvitationResponse": {
        "properties": {
          "accepted_at_unix": {
            "type": "integer"
          },
          "accepted_by": {
            "type": "string"
          },
          "account_description": {
            "type": "string"
          },
          "account_id": {
            "type": "string"
          },
          "account_name": {
            "type": "string"
          },
          "created_at_unix": {
            "type": "integer"
          },
          "email": {
            "type": "string"
          },
          "expires_at_unix": {
            "type": "integer"
          },
          "id": {
            "type": "string"
          },
          "invited_by": {
            "type": "string"
          },
          "role": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "token": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "InvitationResponse"
      },
      "JoinSharedCapacityRequest": {
        "properties": {
          "group_id": {
            "type": "string"
          },
          "public_slug": {
            "type": "string"
          },
          "referral_token": {
            "type": "string"
          },
          "terms_hash": {
            "type": "string"
          },
          "terms_version": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "JoinSharedCapacityRequest"
      },
      "LedgerEntryResponse": {
        "properties": {
          "account_id": {
            "type": "string"
          },
          "amount": {
            "type": "number"
          },
          "balance": {
            "type": "number"
          },
          "created_at": {
            "type": "string"
          },
          "event_type": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "reference": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "LedgerEntryResponse"
      },
      "LedgerHistoryResponse": {
        "properties": {
          "entries": {
            "items": {
              "$ref": "#/components/schemas/LedgerEntryResponse"
            },
            "type": "array"
          },
          "total": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "LedgerHistoryResponse"
      },
      "LegalAcceptanceItem": {
        "properties": {
          "context": {
            "type": "string"
          },
          "document_type": {
            "type": "string"
          },
          "sha256": {
            "type": "string"
          },
          "version": {
            "type": "string"
          }
        },
        "required": [
          "context",
          "document_type",
          "sha256",
          "version"
        ],
        "type": "object",
        "x-go-name": "LegalAcceptanceItem"
      },
      "LegalAcceptanceRequest": {
        "properties": {
          "acceptances": {
            "items": {
              "$ref": "#/components/schemas/LegalAcceptanceItem"
            },
            "maxItems": 3,
            "minItems": 1,
            "type": "array"
          }
        },
        "required": [
          "acceptances"
        ],
        "type": "object",
        "x-go-name": "LegalAcceptanceRequest"
      },
      "ListDocumentsResponse": {
        "properties": {
          "documents": {
            "items": {
              "$ref": "#/components/schemas/ListedDocumentResponse"
            },
            "type": "array"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ListDocumentsResponse"
      },
      "ListNotificationsResponse": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/NotificationResponse"
            },
            "type": "array"
          },
          "next_since": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ListNotificationsResponse"
      },
      "ListUserVariantsResponse": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/VariantWithRelations"
            },
            "type": "array"
          },
          "total": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "ListUserVariantsResponse"
      },
      "ListedDocumentResponse": {
        "properties": {
          "content": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object"
          },
          "source": {
            "$ref": "#/components/schemas/SearchHitSourceResponse"
          },
          "updated_at": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ListedDocumentResponse"
      },
      "LoginRequest": {
        "properties": {
          "cf_turnstile_response": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "password": {
            "type": "string"
          },
          "totp_code": {
            "type": "string"
          }
        },
        "required": [
          "email",
          "password"
        ],
        "type": "object",
        "x-go-name": "LoginRequest"
      },
      "LoginResponse": {
        "properties": {
          "next_step": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "LoginResponse"
      },
      "MarkAllReadRequest": {
        "properties": {
          "kind": {
            "type": "string"
          },
          "severity": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "MarkAllReadRequest"
      },
      "MarkAllReadResponse": {
        "properties": {
          "marked": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "MarkAllReadResponse"
      },
      "Model": {
        "properties": {
          "display_name": {
            "type": "string"
          },
          "downloads": {
            "type": "integer"
          },
          "likes": {
            "type": "integer"
          },
          "organization": {
            "type": "string"
          },
          "organization_logo_url": {
            "type": "string"
          },
          "pipeline_tag": {
            "type": "string"
          },
          "price_eur_per_hour": {
            "type": "number"
          },
          "pricing_status": {
            "$ref": "#/components/schemas/PricingStatus"
          },
          "recommended_gpu": {
            "$ref": "#/components/schemas/RecommendedGPU"
          },
          "repo_id": {
            "type": "string"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "Model"
      },
      "ModelPricesResponse": {
        "properties": {
          "models": {
            "items": {
              "$ref": "#/components/schemas/Model"
            },
            "type": "array"
          },
          "query": {
            "type": "string"
          },
          "services": {
            "items": {
              "$ref": "#/components/schemas/PricingService"
            },
            "type": "array"
          },
          "source": {
            "type": "string"
          },
          "source_status": {
            "type": "string"
          },
          "stale": {
            "type": "boolean"
          },
          "updated_at": {
            "type": "string"
          },
          "version": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "ModelPricesResponse"
      },
      "NotificationLinkResponse": {
        "properties": {
          "kind_route": {
            "type": "string"
          },
          "label_key": {
            "type": "string"
          },
          "route_args": {
            "additionalProperties": {},
            "type": "object"
          }
        },
        "type": "object",
        "x-go-name": "NotificationLinkResponse"
      },
      "NotificationResponse": {
        "properties": {
          "body_args": {
            "additionalProperties": {},
            "type": "object"
          },
          "body_key": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "dedupe_key": {
            "type": "string"
          },
          "dismissed": {
            "type": "boolean"
          },
          "expires_at": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "links": {
            "items": {
              "$ref": "#/components/schemas/NotificationLinkResponse"
            },
            "type": "array"
          },
          "metadata": {
            "additionalProperties": {},
            "type": "object"
          },
          "read": {
            "type": "boolean"
          },
          "severity": {
            "type": "string"
          },
          "source_topic": {
            "type": "string"
          },
          "title_args": {
            "additionalProperties": {},
            "type": "object"
          },
          "title_key": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "NotificationResponse"
      },
      "OauthSignupRequest": {
        "properties": {
          "cf_turnstile_response": {
            "type": "string"
          },
          "continuation_token": {
            "type": "string"
          },
          "privacy_acknowledged": {
            "type": "boolean"
          },
          "privacy_sha256": {
            "type": "string"
          },
          "privacy_version": {
            "type": "string"
          },
          "terms_accepted": {
            "type": "boolean"
          },
          "terms_sha256": {
            "type": "string"
          },
          "terms_version": {
            "type": "string"
          }
        },
        "required": [
          "continuation_token",
          "privacy_acknowledged",
          "privacy_sha256",
          "privacy_version",
          "terms_accepted",
          "terms_sha256",
          "terms_version"
        ],
        "type": "object",
        "x-go-name": "OauthSignupRequest"
      },
      "OauthTOTPRequest": {
        "properties": {
          "cf_turnstile_response": {
            "type": "string"
          },
          "continuation_token": {
            "type": "string"
          },
          "totp_code": {
            "type": "string"
          }
        },
        "required": [
          "continuation_token",
          "totp_code"
        ],
        "type": "object",
        "x-go-name": "OauthTOTPRequest"
      },
      "PasskeyListResponse": {
        "properties": {
          "passkeys": {
            "items": {
              "$ref": "#/components/schemas/PasskeyResponse"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "PasskeyListResponse"
      },
      "PasskeyResponse": {
        "properties": {
          "credential_id": {
            "type": "string"
          },
          "public_key": {
            "type": "string"
          },
          "sign_count": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "PasskeyResponse"
      },
      "PaymentResponse": {
        "properties": {
          "account_id": {
            "type": "string"
          },
          "amount_credit_base_minor": {
            "type": "integer"
          },
          "amount_discount_minor": {
            "type": "integer"
          },
          "amount_subtotal_minor": {
            "type": "integer"
          },
          "amount_tax_minor": {
            "type": "integer"
          },
          "amount_total_minor": {
            "type": "integer"
          },
          "created_at": {
            "type": "string"
          },
          "credited_at": {
            "type": "string"
          },
          "credited_eur_cents": {
            "type": "integer"
          },
          "currency": {
            "type": "string"
          },
          "discount_code_snapshot": {
            "type": "string"
          },
          "discount_ticket_id": {
            "type": "string"
          },
          "document_status": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "ledger_entry_id": {
            "type": "string"
          },
          "paid_at": {
            "type": "string"
          },
          "provider": {
            "type": "string"
          },
          "reference": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "stripe_customer_id": {
            "type": "string"
          },
          "stripe_event_id": {
            "type": "string"
          },
          "stripe_invoice_id": {
            "type": "string"
          },
          "stripe_payment_intent_id": {
            "type": "string"
          },
          "stripe_session_id": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "PaymentResponse"
      },
      "PaymentsResponse": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/PaymentResponse"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "PaymentsResponse"
      },
      "PreviewInstanceResponse": {
        "properties": {
          "capacity_tier": {
            "type": "string"
          },
          "compatible_gpus": {
            "items": {
              "$ref": "#/components/schemas/CatalogGPUResponse"
            },
            "type": "array"
          },
          "estimate": {
            "$ref": "#/components/schemas/RuntimeMemoryEstimateResponse"
          },
          "huggingface_repo_id": {
            "type": "string"
          },
          "max_context_size": {
            "type": "integer"
          },
          "recommended_gpu": {
            "$ref": "#/components/schemas/CatalogGPUResponse"
          },
          "runtime_config": {
            "$ref": "#/components/schemas/RuntimeConfigResponse"
          },
          "runtime_preset": {
            "type": "string"
          },
          "scheduling_mode": {
            "type": "string"
          },
          "smart_allow_community": {
            "type": "boolean"
          },
          "smart_allow_spot": {
            "type": "boolean"
          },
          "smart_current_gpu": {
            "$ref": "#/components/schemas/CatalogGPUResponse"
          },
          "smart_current_price_per_hour_eur": {
            "type": "number"
          },
          "smart_max_price_per_hour_eur": {
            "type": "number"
          },
          "smart_min_gpu_class": {
            "type": "string"
          },
          "smart_min_total_tflops": {
            "type": "number"
          },
          "smart_provider_filter_mode": {
            "type": "string"
          },
          "smart_provider_preference": {
            "type": "string"
          },
          "smart_recommended_max_price_per_hour_eur": {
            "type": "number"
          },
          "smart_region": {
            "type": "string"
          },
          "smart_regions": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "smart_selection_label": {
            "type": "string"
          },
          "warnings": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "workload_kind": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "PreviewInstanceResponse"
      },
      "PreviewInstanceUpdateRequest": {
        "properties": {
          "scheduling_mode": {
            "type": "string"
          },
          "smart_allow_community": {
            "type": "boolean"
          },
          "smart_allow_spot": {
            "type": "boolean"
          },
          "smart_max_price_per_hour_eur": {
            "type": "number"
          },
          "smart_min_gpu_class": {
            "type": "string"
          },
          "smart_min_total_tflops": {
            "type": "number"
          },
          "smart_provider_filter_mode": {
            "type": "string"
          },
          "smart_provider_preference": {
            "type": "string"
          },
          "smart_region": {
            "type": "string"
          },
          "smart_regions": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "smart_selection_label": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "PreviewInstanceUpdateRequest"
      },
      "PricingService": {
        "properties": {
          "currency": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "price_eur_per_gb_hour": {
            "exclusiveMinimum": true,
            "minimum": 0,
            "type": "number"
          },
          "status": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "PricingService"
      },
      "PricingStatus": {
        "enum": [
          "estimated",
          "unavailable"
        ],
        "type": "string",
        "x-enum-varnames": [
          "PricingEstimated",
          "PricingUnavailable"
        ],
        "x-go-name": "PricingStatus"
      },
      "Protocol.ContextManagement": {
        "properties": {
          "compact_threshold": {
            "type": "integer"
          },
          "type": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "Protocol.ContextManagement"
      },
      "PublicEndpointPriceResponse": {
        "properties": {
          "input_per_million_eur": {
            "type": "number"
          },
          "output_per_million_eur": {
            "type": "number"
          }
        },
        "type": "object",
        "x-go-name": "PublicEndpointPriceResponse"
      },
      "PublicEndpointResponse": {
        "properties": {
          "name": {
            "type": "string"
          },
          "price": {
            "$ref": "#/components/schemas/PublicEndpointPriceResponse"
          }
        },
        "type": "object",
        "x-go-name": "PublicEndpointResponse"
      },
      "PublicEndpointsResponse": {
        "properties": {
          "endpoints": {
            "items": {
              "$ref": "#/components/schemas/PublicEndpointResponse"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "PublicEndpointsResponse"
      },
      "PublicGPUPreferenceJSON": {
        "properties": {
          "count": {
            "type": "integer"
          },
          "public_gpu_id": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "PublicGPUPreferenceJSON"
      },
      "PublicPricingAvailability": {
        "properties": {
          "count": {
            "type": "integer"
          },
          "status": {
            "type": "string"
          },
          "total": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "PublicPricingAvailability"
      },
      "PublicPricingGPU": {
        "properties": {
          "availability": {
            "$ref": "#/components/schemas/PublicPricingAvailability"
          },
          "capacity_tier": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "display_name": {
            "type": "string"
          },
          "gpu_count": {
            "type": "integer"
          },
          "market_type": {
            "type": "string"
          },
          "price_eur_per_hour": {
            "type": "number"
          },
          "provider_codename": {
            "type": "string"
          },
          "public_gpu_id": {
            "type": "string"
          },
          "region": {
            "type": "string"
          },
          "vram_gb": {
            "type": "number"
          }
        },
        "type": "object",
        "x-go-name": "PublicPricingGPU"
      },
      "PublicPricingResponse": {
        "properties": {
          "services": {
            "items": {
              "$ref": "#/components/schemas/PublicPricingService"
            },
            "type": "array"
          },
          "updated_at": {
            "type": "string"
          },
          "version": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "PublicPricingResponse"
      },
      "PublicPricingService": {
        "properties": {
          "billing_model": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "gpus": {
            "items": {
              "$ref": "#/components/schemas/PublicPricingGPU"
            },
            "type": "array"
          },
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "price_eur_per_gb_hour": {
            "exclusiveMinimum": true,
            "minimum": 0,
            "type": "number"
          },
          "status": {
            "type": "string"
          },
          "unit": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "PublicPricingService"
      },
      "QueuedDebitResponse": {
        "properties": {
          "operation_id": {
            "type": "string"
          },
          "queued": {
            "type": "boolean"
          }
        },
        "type": "object",
        "x-go-name": "QueuedDebitResponse"
      },
      "RecommendRequest": {
        "properties": {
          "recommend_token": {
            "type": "string"
          },
          "top_k": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "RecommendRequest"
      },
      "RecommendedGPU": {
        "properties": {
          "availability": {
            "type": "string"
          },
          "display_name": {
            "type": "string"
          },
          "gpu_count": {
            "type": "integer"
          },
          "market_type": {
            "type": "string"
          },
          "vram_gb": {
            "type": "number"
          }
        },
        "type": "object",
        "x-go-name": "RecommendedGPU"
      },
      "RefreshResponse": {
        "type": "object",
        "x-go-name": "RefreshResponse"
      },
      "RegisterPasskeyRequest": {
        "properties": {
          "credential_id": {
            "type": "string"
          },
          "public_key": {
            "type": "string"
          },
          "sign_count": {
            "type": "integer"
          }
        },
        "required": [
          "credential_id",
          "public_key"
        ],
        "type": "object",
        "x-go-name": "RegisterPasskeyRequest"
      },
      "RegisterRequest": {
        "properties": {
          "cf_turnstile_response": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "password": {
            "minLength": 8,
            "type": "string"
          },
          "privacy_acknowledged": {
            "type": "boolean"
          },
          "privacy_sha256": {
            "type": "string"
          },
          "privacy_version": {
            "type": "string"
          },
          "resend": {
            "type": "boolean"
          },
          "terms_accepted": {
            "type": "boolean"
          },
          "terms_sha256": {
            "type": "string"
          },
          "terms_version": {
            "type": "string"
          }
        },
        "required": [
          "email",
          "password",
          "privacy_acknowledged",
          "privacy_sha256",
          "privacy_version",
          "terms_accepted",
          "terms_sha256",
          "terms_version"
        ],
        "type": "object",
        "x-go-name": "RegisterRequest"
      },
      "RegisterResponse": {
        "properties": {
          "requires_verification": {
            "type": "boolean"
          },
          "user_id": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "RegisterResponse"
      },
      "ReplicaSetListResponse": {
        "properties": {
          "replica_sets": {
            "items": {
              "$ref": "#/components/schemas/ReplicaSetResponse"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "ReplicaSetListResponse"
      },
      "ReplicaSetResponse": {
        "properties": {
          "account_id": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "desired_replicas": {
            "type": "integer"
          },
          "gguf_model_path": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "min_replicas": {
            "type": "integer"
          },
          "model_ref": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "runtime_config_snapshot": {
            "type": "string"
          },
          "scheduling_mode": {
            "type": "string"
          },
          "serving_endpoint_id": {
            "type": "string"
          },
          "serving_name": {
            "type": "string"
          },
          "smart_allow_community": {
            "type": "boolean"
          },
          "smart_allow_spot": {
            "type": "boolean"
          },
          "smart_max_price_per_hour_usd": {
            "type": "number"
          },
          "smart_min_gpu_class": {
            "type": "string"
          },
          "smart_min_total_tflops": {
            "type": "number"
          },
          "smart_provider_filter_mode": {
            "type": "string"
          },
          "smart_provider_preference": {
            "type": "string"
          },
          "smart_region": {
            "type": "string"
          },
          "smart_regions": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "smart_selection_label": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "supported_protocols": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "target_group_id": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          },
          "workload_kind": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ReplicaSetResponse"
      },
      "ResendActivationEmailRequest": {
        "properties": {
          "cf_turnstile_response": {
            "type": "string"
          },
          "email": {
            "type": "string"
          }
        },
        "required": [
          "email"
        ],
        "type": "object",
        "x-go-name": "ResendActivationEmailRequest"
      },
      "ResendEmailResponse": {
        "properties": {
          "message": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ResendEmailResponse"
      },
      "ResendLoginEmailRequest": {
        "properties": {
          "cf_turnstile_response": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "password": {
            "type": "string"
          }
        },
        "required": [
          "email",
          "password"
        ],
        "type": "object",
        "x-go-name": "ResendLoginEmailRequest"
      },
      "ResetPasswordRequest": {
        "properties": {
          "cf_turnstile_response": {
            "type": "string"
          },
          "new_password": {
            "minLength": 8,
            "type": "string"
          },
          "token": {
            "type": "string"
          }
        },
        "required": [
          "new_password",
          "token"
        ],
        "type": "object",
        "x-go-name": "ResetPasswordRequest"
      },
      "ResetPasswordResponse": {
        "properties": {
          "email": {
            "type": "string"
          },
          "user_id": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ResetPasswordResponse"
      },
      "ResourceMetricSnapshot": {
        "properties": {
          "e2e_request_latency_p95_seconds": {
            "type": "number"
          },
          "generation_tokens_total": {
            "type": "number"
          },
          "kv_cache_usage_percent": {
            "type": "number"
          },
          "prompt_tokens_total": {
            "type": "number"
          },
          "requests_running": {
            "type": "number"
          },
          "requests_waiting": {
            "type": "number"
          },
          "runtime_cpu_seconds_per_second": {
            "type": "number"
          },
          "runtime_memory_bytes": {
            "type": "number"
          },
          "sampled_at": {
            "type": "string"
          },
          "time_to_first_token_p95_seconds": {
            "type": "number"
          }
        },
        "type": "object",
        "x-go-name": "ResourceMetricSnapshot"
      },
      "ResourceMetricsResponse": {
        "properties": {
          "latest": {
            "$ref": "#/components/schemas/ResourceMetricSnapshot"
          },
          "retention_seconds": {
            "type": "integer"
          },
          "sample_interval_seconds": {
            "type": "integer"
          },
          "series": {
            "items": {
              "$ref": "#/components/schemas/ResourceMetricSnapshot"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "ResourceMetricsResponse"
      },
      "ResponsesRequestEnvelope": {
        "properties": {
          "context_management": {
            "items": {
              "$ref": "#/components/schemas/Protocol.ContextManagement"
            },
            "type": "array"
          },
          "input": {
            "items": {
              "type": "integer"
            },
            "type": "array"
          },
          "instructions": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object"
          },
          "model": {
            "type": "string"
          },
          "previous_response_id": {
            "type": "string"
          },
          "reasoning": {
            "properties": {
              "effort": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "reasoning_effort": {
            "type": "string"
          },
          "store": {
            "type": "boolean"
          },
          "stream": {
            "type": "boolean"
          },
          "thinking_token_budget": {
            "type": "integer"
          },
          "tools": {
            "items": {
              "type": "integer"
            },
            "type": "array"
          },
          "type": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ResponsesRequestEnvelope"
      },
      "RuntimeConfigRequest": {
        "properties": {
          "context_size": {
            "type": "integer"
          },
          "dtype": {
            "type": "string"
          },
          "duplex": {
            "type": "boolean"
          },
          "gpu_memory_utilization": {
            "type": "number"
          },
          "kv_cache_dtype": {
            "type": "string"
          },
          "max_num_batched_tokens": {
            "type": "integer"
          },
          "profile": {
            "type": "string"
          },
          "quantization": {
            "type": "string"
          },
          "storage_mounts": {
            "items": {
              "properties": {
                "mount_path": {
                  "type": "string"
                },
                "set_hf_home": {
                  "type": "boolean"
                },
                "subpath": {
                  "type": "string"
                },
                "volume_id": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "tensor_parallel_size": {
            "type": "integer"
          },
          "yolo_model_file": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "RuntimeConfigRequest"
      },
      "RuntimeConfigResponse": {
        "properties": {
          "context_size": {
            "type": "integer"
          },
          "dtype": {
            "type": "string"
          },
          "duplex": {
            "type": "boolean"
          },
          "gpu_memory_utilization": {
            "type": "number"
          },
          "kv_cache_dtype": {
            "type": "string"
          },
          "max_num_batched_tokens": {
            "type": "integer"
          },
          "profile": {
            "type": "string"
          },
          "quantization": {
            "type": "string"
          },
          "storage_mounts": {
            "items": {
              "properties": {
                "mount_path": {
                  "type": "string"
                },
                "set_hf_home": {
                  "type": "boolean"
                },
                "subpath": {
                  "type": "string"
                },
                "volume_id": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "task_type": {
            "type": "string"
          },
          "tensor_parallel_size": {
            "type": "integer"
          },
          "yolo_model_file": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "RuntimeConfigResponse"
      },
      "RuntimeMemoryEstimateResponse": {
        "properties": {
          "active_parameter_count": {
            "type": "integer"
          },
          "download_size_bytes": {
            "type": "integer"
          },
          "gpu_memory_utilization": {
            "type": "number"
          },
          "kv_cache_vram_gb": {
            "type": "number"
          },
          "model_vram_gb": {
            "type": "number"
          },
          "parameter_count": {
            "type": "integer"
          },
          "per_gpu_required_vram_gb": {
            "type": "number"
          },
          "required_vram_gb": {
            "type": "number"
          },
          "tensor_parallel_size": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "RuntimeMemoryEstimateResponse"
      },
      "ScaleReplicaSetRequest": {
        "properties": {
          "desired_replicas": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "ScaleReplicaSetRequest"
      },
      "ScheduleRuleListResponse": {
        "properties": {
          "schedule_rules": {
            "items": {
              "$ref": "#/components/schemas/ScheduleRuleResponse"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "ScheduleRuleListResponse"
      },
      "ScheduleRuleRequest": {
        "properties": {
          "action": {
            "type": "string"
          },
          "cron": {
            "type": "string"
          },
          "desired_replicas": {
            "type": "integer"
          },
          "enabled": {
            "type": "boolean"
          },
          "replica_set_id": {
            "type": "string"
          },
          "timezone": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ScheduleRuleRequest"
      },
      "ScheduleRuleResponse": {
        "properties": {
          "action": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "cron": {
            "type": "string"
          },
          "desired_replicas": {
            "type": "integer"
          },
          "enabled": {
            "type": "boolean"
          },
          "id": {
            "type": "string"
          },
          "instance_id": {
            "type": "string"
          },
          "last_error": {
            "type": "string"
          },
          "last_run_at": {
            "type": "string"
          },
          "next_run_at": {
            "type": "string"
          },
          "replica_set_id": {
            "type": "string"
          },
          "timezone": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ScheduleRuleResponse"
      },
      "SearchHitResponse": {
        "properties": {
          "content": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object"
          },
          "score": {
            "type": "number"
          },
          "source": {
            "$ref": "#/components/schemas/SearchHitSourceResponse"
          }
        },
        "type": "object",
        "x-go-name": "SearchHitResponse"
      },
      "SearchHitSourceResponse": {
        "properties": {
          "image_url": {
            "type": "string"
          },
          "text": {
            "type": "string"
          },
          "truncate": {
            "type": "boolean"
          }
        },
        "type": "object",
        "x-go-name": "SearchHitSourceResponse"
      },
      "SearchRecommendRequest": {
        "properties": {
          "bias": {
            "type": "number"
          },
          "token": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "SearchRecommendRequest"
      },
      "SearchRequest": {
        "properties": {
          "image_url": {
            "type": "string"
          },
          "query": {
            "type": "string"
          },
          "recommend": {
            "$ref": "#/components/schemas/SearchRecommendRequest"
          },
          "top_k": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "SearchRequest"
      },
      "Service.BiomolecularArtifact": {
        "properties": {
          "filename": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "media_type": {
            "type": "string"
          },
          "size_bytes": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "Service.BiomolecularArtifact"
      },
      "Service.BiomolecularAttachment": {
        "properties": {
          "content": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "Service.BiomolecularAttachment"
      },
      "Service.BiomolecularJobResult": {
        "properties": {
          "affinity": {
            "additionalProperties": {},
            "type": "object"
          },
          "artifacts": {
            "items": {
              "$ref": "#/components/schemas/Service.BiomolecularArtifact"
            },
            "type": "array"
          },
          "completed_at": {
            "type": "string"
          },
          "confidence": {
            "items": {
              "additionalProperties": {},
              "type": "object"
            },
            "type": "array"
          },
          "created_at": {
            "type": "string"
          },
          "error": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": {},
            "type": "object"
          },
          "model": {
            "type": "string"
          },
          "started_at": {
            "type": "string"
          },
          "status": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "Service.BiomolecularJobResult"
      },
      "Service.BiomolecularOptions": {
        "properties": {
          "affinity_mw_correction": {
            "type": "boolean"
          },
          "diffusion_samples": {
            "type": "integer"
          },
          "diffusion_samples_affinity": {
            "type": "integer"
          },
          "max_msa_seqs": {
            "type": "integer"
          },
          "msa_pairing_strategy": {
            "type": "string"
          },
          "output_format": {
            "type": "string"
          },
          "recycling_steps": {
            "type": "integer"
          },
          "sampling_steps": {
            "type": "integer"
          },
          "sampling_steps_affinity": {
            "type": "integer"
          },
          "seed": {
            "type": "integer"
          },
          "use_msa_server": {
            "type": "boolean"
          },
          "use_potentials": {
            "type": "boolean"
          }
        },
        "type": "object",
        "x-go-name": "Service.BiomolecularOptions"
      },
      "Service.BiomolecularSubmitRequest": {
        "properties": {
          "attachments": {
            "items": {
              "$ref": "#/components/schemas/Service.BiomolecularAttachment"
            },
            "type": "array"
          },
          "input": {
            "additionalProperties": {},
            "type": "object"
          },
          "model": {
            "type": "string"
          },
          "options": {
            "$ref": "#/components/schemas/Service.BiomolecularOptions"
          }
        },
        "required": [
          "input",
          "model"
        ],
        "type": "object",
        "x-go-name": "Service.BiomolecularSubmitRequest"
      },
      "ServingEndpointResponse": {
        "properties": {
          "created_at": {
            "type": "string"
          },
          "display_name": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "endpoint_type": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "model_ids": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "name": {
            "type": "string"
          },
          "providers": {
            "items": {
              "$ref": "#/components/schemas/ServingProviderResponse"
            },
            "type": "array"
          },
          "public_input_per_million_eur": {
            "type": "number"
          },
          "public_output_per_million_eur": {
            "type": "number"
          },
          "realtime_mode": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "supported_protocols": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "supports_duplex": {
            "type": "boolean"
          },
          "supports_realtime": {
            "type": "boolean"
          },
          "supports_server_vad": {
            "type": "boolean"
          },
          "supports_thinking": {
            "type": "boolean"
          },
          "targets": {
            "items": {
              "$ref": "#/components/schemas/ServingTargetResponse"
            },
            "type": "array"
          },
          "updated_at": {
            "type": "string"
          },
          "workload_kind": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ServingEndpointResponse"
      },
      "ServingProviderResponse": {
        "properties": {
          "model_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "region": {
            "type": "string"
          },
          "supported_protocols": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "supports_tools": {
            "type": "boolean"
          }
        },
        "type": "object",
        "x-go-name": "ServingProviderResponse"
      },
      "ServingTargetRequest": {
        "properties": {
          "instance_id": {
            "type": "string"
          },
          "target_ref_id": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "ServingTargetRequest"
      },
      "ServingTargetResponse": {
        "properties": {
          "created_at": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "id": {
            "type": "string"
          },
          "instance_id": {
            "type": "string"
          },
          "priority": {
            "type": "integer"
          },
          "supported_protocols": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "target_ref_id": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          },
          "weight": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "ServingTargetResponse"
      },
      "SharedCapacityInstanceResponse": {
        "properties": {
          "capacity_tier": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "gpu": {
            "type": "string"
          },
          "gpu_count": {
            "type": "integer"
          },
          "model_ref": {
            "type": "string"
          },
          "public_price_per_hour_microcents": {
            "type": "integer"
          },
          "started_at": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "storage_price_per_hour_microcents": {
            "type": "integer"
          },
          "workload_kind": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "SharedCapacityInstanceResponse"
      },
      "SharedCapacityLinkResponse": {
        "properties": {
          "created_by_account_id": {
            "type": "string"
          },
          "expires_at": {
            "type": "string"
          },
          "group_id": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "token": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "SharedCapacityLinkResponse"
      },
      "SharedCapacityListResponse": {
        "properties": {
          "capacities": {
            "items": {
              "$ref": "#/components/schemas/SharedCapacityResponse"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "SharedCapacityListResponse"
      },
      "SharedCapacityMembershipResponse": {
        "properties": {
          "accepted_at": {
            "type": "string"
          },
          "accepted_terms_hash": {
            "type": "string"
          },
          "accepted_terms_version": {
            "type": "string"
          },
          "active_member_count": {
            "type": "integer"
          },
          "amount_microcents": {
            "type": "integer"
          },
          "base_price_eur_per_hour": {
            "type": "number"
          },
          "base_price_microcents_per_hour": {
            "type": "integer"
          },
          "base_price_microcents_per_second": {
            "type": "integer"
          },
          "created_at": {
            "type": "string"
          },
          "current_member_price_eur_per_hour": {
            "type": "number"
          },
          "current_member_price_microcents_per_hour": {
            "type": "integer"
          },
          "effective_from": {
            "type": "string"
          },
          "group_id": {
            "type": "string"
          },
          "instance": {
            "$ref": "#/components/schemas/SharedCapacityInstanceResponse"
          },
          "leave_effective_at": {
            "type": "string"
          },
          "left_at": {
            "type": "string"
          },
          "max_members": {
            "type": "integer"
          },
          "member_price_microcents_per_second": {
            "type": "integer"
          },
          "membership_id": {
            "type": "string"
          },
          "reservation_attached": {
            "type": "boolean"
          },
          "reservation_state": {
            "type": "string"
          },
          "role": {
            "type": "string"
          },
          "serving_alias_id": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "suspended_at": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "SharedCapacityMembershipResponse"
      },
      "SharedCapacityPublicListResponse": {
        "properties": {
          "capacities": {
            "items": {
              "$ref": "#/components/schemas/SharedCapacityPublicResponse"
            },
            "type": "array"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "SharedCapacityPublicListResponse"
      },
      "SharedCapacityPublicResponse": {
        "properties": {
          "active_member_count": {
            "type": "integer"
          },
          "availability_mode": {
            "type": "string"
          },
          "base_price_eur_per_hour": {
            "type": "number"
          },
          "base_price_microcents_per_hour": {
            "type": "integer"
          },
          "base_price_microcents_per_second": {
            "type": "integer"
          },
          "capacity_tier": {
            "type": "string"
          },
          "estimated_join_price_eur_per_hour": {
            "type": "number"
          },
          "estimated_join_price_microcents_per_hour": {
            "type": "integer"
          },
          "gpu": {
            "type": "string"
          },
          "instance_state": {
            "type": "string"
          },
          "max_members": {
            "type": "integer"
          },
          "member_price_microcents_per_second": {
            "type": "integer"
          },
          "model_description": {
            "type": "string"
          },
          "model_ref": {
            "type": "string"
          },
          "selection_mode": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "terms_hash": {
            "type": "string"
          },
          "terms_version": {
            "type": "string"
          },
          "visibility": {
            "type": "string"
          },
          "workload_kind": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "SharedCapacityPublicResponse"
      },
      "SharedCapacityResponse": {
        "properties": {
          "active_member_count": {
            "type": "integer"
          },
          "backing_instance_id": {
            "type": "string"
          },
          "base_price_eur_per_hour": {
            "type": "number"
          },
          "base_price_microcents_per_hour": {
            "type": "integer"
          },
          "base_price_microcents_per_second": {
            "type": "integer"
          },
          "close_reason": {
            "type": "string"
          },
          "current_member_price_eur_per_hour": {
            "type": "number"
          },
          "current_member_price_microcents_per_hour": {
            "type": "integer"
          },
          "group_id": {
            "type": "string"
          },
          "instance": {
            "$ref": "#/components/schemas/SharedCapacityInstanceResponse"
          },
          "max_members": {
            "type": "integer"
          },
          "member_price_microcents_per_second": {
            "type": "integer"
          },
          "members": {
            "items": {
              "$ref": "#/components/schemas/SharedCapacityMembershipResponse"
            },
            "type": "array"
          },
          "membership": {
            "$ref": "#/components/schemas/SharedCapacityMembershipResponse"
          },
          "public_slug": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "terms_hash": {
            "type": "string"
          },
          "terms_version": {
            "type": "string"
          },
          "visibility": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "SharedCapacityResponse"
      },
      "SmartBalancerRouteDestinationRequest": {
        "properties": {
          "ref": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "SmartBalancerRouteDestinationRequest"
      },
      "SmartBalancerRouteDestinationResponse": {
        "properties": {
          "label": {
            "type": "string"
          },
          "ref": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "SmartBalancerRouteDestinationResponse"
      },
      "SmartBalancerRouteRequest": {
        "properties": {
          "destination": {
            "$ref": "#/components/schemas/SmartBalancerRouteDestinationRequest"
          },
          "enabled": {
            "type": "boolean"
          },
          "intent": {
            "type": "string"
          },
          "is_default": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "priority": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "SmartBalancerRouteRequest"
      },
      "SmartBalancerRouteResponse": {
        "properties": {
          "created_at": {
            "type": "string"
          },
          "destination": {
            "$ref": "#/components/schemas/SmartBalancerRouteDestinationResponse"
          },
          "enabled": {
            "type": "boolean"
          },
          "id": {
            "type": "string"
          },
          "intent": {
            "type": "string"
          },
          "is_default": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "priority": {
            "type": "integer"
          },
          "updated_at": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "SmartBalancerRouteResponse"
      },
      "SmartBalancerRouterModelRequest": {
        "properties": {
          "ref": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "SmartBalancerRouterModelRequest"
      },
      "SmartBalancerRouterModelResponse": {
        "properties": {
          "ref": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "SmartBalancerRouterModelResponse"
      },
      "SmartBalancerViewResponse": {
        "properties": {
          "created_at": {
            "type": "string"
          },
          "default_route_id": {
            "type": "string"
          },
          "display_name": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "router_model": {
            "$ref": "#/components/schemas/SmartBalancerRouterModelResponse"
          },
          "routes": {
            "items": {
              "$ref": "#/components/schemas/SmartBalancerRouteResponse"
            },
            "type": "array"
          },
          "routing_mode": {
            "type": "string"
          },
          "serverless_start_requests": {
            "description": "Requests in the rolling window required before starting stopped serverless destinations.",
            "maximum": 10000,
            "minimum": 1,
            "type": "integer"
          },
          "serverless_start_window_seconds": {
            "description": "Rolling request window in seconds.",
            "maximum": 86400,
            "minimum": 1,
            "type": "integer"
          },
          "serving_endpoint_id": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          },
          "workload_kind": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "SmartBalancerViewResponse"
      },
      "TargetGroupMemberRequest": {
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "instance_id": {
            "type": "string"
          },
          "priority": {
            "type": "integer"
          },
          "weight": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "TargetGroupMemberRequest"
      },
      "TargetGroupMemberResponse": {
        "properties": {
          "created_at": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "id": {
            "type": "string"
          },
          "instance_id": {
            "type": "string"
          },
          "priority": {
            "type": "integer"
          },
          "updated_at": {
            "type": "string"
          },
          "weight": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "TargetGroupMemberResponse"
      },
      "TargetGroupResponse": {
        "properties": {
          "created_at": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "display_name": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "id": {
            "type": "string"
          },
          "members": {
            "items": {
              "$ref": "#/components/schemas/TargetGroupMemberResponse"
            },
            "type": "array"
          },
          "name": {
            "type": "string"
          },
          "selection_policy": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          },
          "workload_kind": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "TargetGroupResponse"
      },
      "Template": {
        "properties": {
          "category": {
            "type": "string"
          },
          "created_at": {
            "$ref": "#/components/schemas/Timestamp"
          },
          "created_by": {
            "type": "string"
          },
          "health_checked_at": {
            "$ref": "#/components/schemas/Timestamp"
          },
          "health_error": {
            "type": "string"
          },
          "health_status": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "is_active": {
            "type": "boolean"
          },
          "is_featured": {
            "type": "boolean"
          },
          "ordering": {
            "type": "integer"
          },
          "slug": {
            "type": "string"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "translations": {
            "items": {
              "$ref": "#/components/schemas/Translation"
            },
            "type": "array"
          },
          "updated_at": {
            "$ref": "#/components/schemas/Timestamp"
          },
          "updated_by": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "Template"
      },
      "TemplateWithVariants": {
        "properties": {
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "template": {
            "$ref": "#/components/schemas/Template"
          },
          "variants": {
            "items": {
              "$ref": "#/components/schemas/VariantWithRelations"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "TemplateWithVariants"
      },
      "Timestamp": {
        "properties": {
          "nanos": {
            "description": "Non-negative fractions of a second at nanosecond resolution. This field is\nthe nanosecond portion of the duration, not an alternative to seconds.\nNegative second values with fractions must still have non-negative nanos\nvalues that count forward in time. Must be between 0 and 999,999,999\ninclusive.",
            "type": "integer"
          },
          "seconds": {
            "description": "Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must\nbe between -62135596800 and 253402300799 inclusive (which corresponds to\n0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z).",
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "Timestamp"
      },
      "Translation": {
        "properties": {
          "description": {
            "type": "string"
          },
          "locale": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "Translation"
      },
      "TutorialProgressResponse": {
        "properties": {
          "completed_step_ids": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "content_version": {
            "type": "integer"
          },
          "found": {
            "type": "boolean"
          },
          "state": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "TutorialProgressResponse"
      },
      "UnreadCountResponse": {
        "properties": {
          "by_severity": {
            "additionalProperties": {
              "format": "int64",
              "type": "integer"
            },
            "type": "object"
          },
          "count": {
            "type": "integer"
          }
        },
        "type": "object",
        "x-go-name": "UnreadCountResponse"
      },
      "UpdateAccountMemberRequest": {
        "properties": {
          "role": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "UpdateAccountMemberRequest"
      },
      "UpdateAccountRequest": {
        "properties": {
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "UpdateAccountRequest"
      },
      "UpdateFirewallRequest": {
        "properties": {
          "description": {
            "type": "string"
          },
          "evaluator_serving_name": {
            "type": "string"
          },
          "mode": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "rule_slugs": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "slug": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "UpdateFirewallRequest"
      },
      "UpdateFirewallRuleRequest": {
        "properties": {
          "category": {
            "type": "string"
          },
          "default_severity": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "prompt": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "UpdateFirewallRuleRequest"
      },
      "UpdateInstanceRequest": {
        "properties": {
          "description": {
            "type": "string"
          },
          "gpu_preferences": {
            "items": {
              "$ref": "#/components/schemas/PublicGPUPreferenceJSON"
            },
            "type": "array"
          },
          "idle_timeout_seconds": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "runtime_config": {
            "$ref": "#/components/schemas/RuntimeConfigRequest"
          },
          "runtime_preset": {
            "type": "string"
          },
          "scheduling_mode": {
            "type": "string"
          },
          "serverless_enabled": {
            "type": "boolean"
          },
          "serving_name": {
            "type": "string"
          },
          "smart_allow_community": {
            "type": "boolean"
          },
          "smart_allow_spot": {
            "type": "boolean"
          },
          "smart_max_price_per_hour_eur": {
            "type": "number"
          },
          "smart_min_gpu_class": {
            "type": "string"
          },
          "smart_min_total_tflops": {
            "type": "number"
          },
          "smart_provider_filter_mode": {
            "type": "string"
          },
          "smart_provider_preference": {
            "type": "string"
          },
          "smart_region": {
            "type": "string"
          },
          "smart_regions": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "smart_selection_label": {
            "type": "string"
          },
          "supported_protocols": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "UpdateInstanceRequest"
      },
      "UpdatePreferencesRequest": {
        "properties": {
          "email_2fa_enabled": {
            "type": "boolean"
          }
        },
        "type": "object",
        "x-go-name": "UpdatePreferencesRequest"
      },
      "UpdateReplicaSetRequest": {
        "properties": {
          "desired_replicas": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "scheduling_mode": {
            "type": "string"
          },
          "serving_name": {
            "type": "string"
          },
          "smart_allow_community": {
            "type": "boolean"
          },
          "smart_allow_spot": {
            "type": "boolean"
          },
          "smart_max_price_per_hour_usd": {
            "type": "number"
          },
          "smart_min_gpu_class": {
            "type": "string"
          },
          "smart_min_total_tflops": {
            "type": "number"
          },
          "smart_provider_filter_mode": {
            "type": "string"
          },
          "smart_provider_preference": {
            "type": "string"
          },
          "smart_regions": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object",
        "x-go-name": "UpdateReplicaSetRequest"
      },
      "UpdateSmartBalancerRequest": {
        "properties": {
          "display_name": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "router_model": {
            "$ref": "#/components/schemas/SmartBalancerRouterModelRequest"
          },
          "routes": {
            "items": {
              "$ref": "#/components/schemas/SmartBalancerRouteRequest"
            },
            "type": "array"
          },
          "routing_mode": {
            "type": "string"
          },
          "serverless_start_requests": {
            "description": "Requests in the rolling window required before starting stopped serverless destinations. Omitted settings retain their stored values.",
            "maximum": 10000,
            "minimum": 1,
            "type": "integer"
          },
          "serverless_start_window_seconds": {
            "description": "Rolling request window in seconds.",
            "maximum": 86400,
            "minimum": 1,
            "type": "integer"
          },
          "workload_kind": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "UpdateSmartBalancerRequest"
      },
      "UpdateTargetGroupRequest": {
        "properties": {
          "description": {
            "type": "string"
          },
          "display_name": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "members": {
            "items": {
              "$ref": "#/components/schemas/TargetGroupMemberRequest"
            },
            "type": "array"
          },
          "selection_policy": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "UpdateTargetGroupRequest"
      },
      "UpdateTutorialProgressRequest": {
        "properties": {
          "completed_step_ids": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "content_version": {
            "type": "integer"
          },
          "state": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "UpdateTutorialProgressRequest"
      },
      "UpdateVectorDatabaseRequest": {
        "properties": {
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "UpdateVectorDatabaseRequest"
      },
      "UserInfoResponse": {
        "properties": {
          "email": {
            "type": "string"
          },
          "impersonating": {
            "$ref": "#/components/schemas/ImpersonationInfo"
          },
          "user_id": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "UserInfoResponse"
      },
      "UserPreferencesResponse": {
        "properties": {
          "email_2fa_enabled": {
            "type": "boolean"
          },
          "totp_enabled": {
            "type": "boolean"
          }
        },
        "type": "object",
        "x-go-name": "UserPreferencesResponse"
      },
      "Variant": {
        "properties": {
          "artifact_type": {
            "type": "string"
          },
          "created_at": {
            "$ref": "#/components/schemas/Timestamp"
          },
          "gguf_files": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "health_checked_at": {
            "$ref": "#/components/schemas/Timestamp"
          },
          "health_error": {
            "type": "string"
          },
          "health_status": {
            "type": "string"
          },
          "icon_url": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "is_active": {
            "type": "boolean"
          },
          "max_context_tokens": {
            "type": "integer"
          },
          "model_id": {
            "type": "string"
          },
          "ordering": {
            "type": "integer"
          },
          "quantization": {
            "type": "string"
          },
          "recommended_preset": {
            "type": "string"
          },
          "revision": {
            "type": "string"
          },
          "stop_sequences": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "system_prompt": {
            "type": "string"
          },
          "temperature": {
            "type": "number"
          },
          "template_id": {
            "type": "string"
          },
          "translations": {
            "items": {
              "$ref": "#/components/schemas/VariantTranslation"
            },
            "type": "array"
          },
          "updated_at": {
            "$ref": "#/components/schemas/Timestamp"
          }
        },
        "type": "object",
        "x-go-name": "Variant"
      },
      "VariantTranslation": {
        "properties": {
          "description": {
            "type": "string"
          },
          "locale": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "VariantTranslation"
      },
      "VariantWithRelations": {
        "properties": {
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "template_category": {
            "type": "string"
          },
          "template_is_active": {
            "type": "boolean"
          },
          "template_slug": {
            "type": "string"
          },
          "template_tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "variant": {
            "$ref": "#/components/schemas/Variant"
          }
        },
        "type": "object",
        "x-go-name": "VariantWithRelations"
      },
      "VectorDatabaseResponse": {
        "properties": {
          "account_id": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "embedding_model_ref": {
            "type": "string"
          },
          "embedding_serving_name": {
            "type": "string"
          },
          "error_message": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "opensearch_index_name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "VectorDatabaseResponse"
      },
      "VerifyEmailResponse": {
        "properties": {
          "email": {
            "type": "string"
          },
          "user_id": {
            "type": "string"
          }
        },
        "type": "object",
        "x-go-name": "VerifyEmailResponse"
      },
      "ViewElementRequest": {
        "properties": {
          "document_id": {
            "type": "string"
          },
          "recommend_token": {
            "type": "string"
          },
          "weight": {
            "type": "number"
          }
        },
        "type": "object",
        "x-go-name": "ViewElementRequest"
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "description": "Programmatic API keys use Authorization: Bearer tk_\u003cprefix\u003e.\u003csecret\u003e for account keys and Authorization: Bearer uk_\u003cprefix\u003e.\u003csecret\u003e for user keys.",
        "in": "header",
        "name": "Authorization",
        "type": "apiKey"
      },
      "BearerAuth": {
        "description": "Registration requires email verification and does not issue a session. Successful login and session flows use HTTP-only qdiv0_access and qdiv0_refresh browser-session cookies. Tool-deployment routes accept Authorization: Bearer tk_\u003cprefix\u003e.\u003csecret\u003e account API keys and Authorization: Bearer uk_\u003cprefix\u003e.\u003csecret\u003e user API keys.",
        "in": "header",
        "name": "Authorization",
        "type": "apiKey"
      },
      "MetricsAPIKeyAuth": {
        "description": "Prometheus endpoints require Authorization: Bearer \u003cmetrics API key\u003e.",
        "in": "header",
        "name": "Authorization",
        "type": "apiKey"
      },
      "RuntimeJWTAuth": {
        "bearerFormat": "JWT",
        "description": "Runtime JWTs use the Authorization: Bearer \u003cjwt\u003e form on runtime crash-notification requests.",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "contact": {},
    "description": "REST gateway for authentication, account, and billing operations.",
    "title": "Tokenfactory API Gateway",
    "version": "v1beta"
  },
  "openapi": "3.0.3",
  "paths": {
    "/api/show": {
      "post": {
        "description": "Returns the enabled account model's effective context and capabilities in Ollama-compatible form. This metadata query does not run inference or start instances.",
        "operationId": "postOllamaShow",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Show model metadata",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/health": {
      "get": {
        "description": "Returns service health",
        "operationId": "",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "ok"
          }
        },
        "summary": "Health check",
        "tags": [
          "System"
        ]
      }
    },
    "/runtime/notify/crash": {
      "post": {
        "description": "Handles crash notifications from runtime pods. The request must include a valid runtime JWT in the Authorization header (not a user Bearer token).",
        "operationId": "postRuntimeNotifyCrash",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "RuntimeJWTAuth": []
          }
        ],
        "summary": "Report a runtime pod crash",
        "tags": [
          "System"
        ]
      }
    },
    "/v1/accounts": {
      "get": {
        "description": "Returns the accounts and memberships visible to the authenticated user.",
        "operationId": "getAccounts",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountListResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List user accounts",
        "tags": [
          "Accounts"
        ]
      },
      "post": {
        "description": "Creates a new account owned by the authenticated user.",
        "operationId": "postAccounts",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAccountRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountMembershipResponse"
                }
              }
            },
            "description": "Created"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create an account",
        "tags": [
          "Accounts"
        ]
      }
    },
    "/v1/accounts/current": {
      "delete": {
        "description": "Deletes the active account context.",
        "operationId": "deleteAccountsCurrent",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Delete the selected account",
        "tags": [
          "Accounts"
        ]
      },
      "get": {
        "description": "Returns the account resolved from the active account context.",
        "operationId": "getAccountsCurrent",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get the selected account",
        "tags": [
          "Accounts"
        ]
      },
      "patch": {
        "description": "Updates editable metadata for the active account context.",
        "operationId": "patchAccountsCurrent",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAccountRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Update the selected account",
        "tags": [
          "Accounts"
        ]
      }
    },
    "/v1/accounts/current/invitations": {
      "post": {
        "description": "Invites a user by email to join the active account context with a given role.",
        "operationId": "postAccountsCurrentInvitations",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateInvitationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InvitationResponse"
                }
              }
            },
            "description": "Created"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "412": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Precondition Failed"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create an invitation for the selected account",
        "tags": [
          "Invitations"
        ]
      }
    },
    "/v1/accounts/current/invitations/{invitationID}": {
      "delete": {
        "description": "Cancels a pending invitation issued by the active account context.",
        "operationId": "deleteAccountsCurrentInvitationsByInvitationID",
        "parameters": [
          {
            "description": "Invitation ID",
            "in": "path",
            "name": "invitationID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Cancel an invitation for the selected account",
        "tags": [
          "Invitations"
        ]
      }
    },
    "/v1/accounts/current/members": {
      "get": {
        "description": "Returns the members and roles for the active account context.",
        "operationId": "getAccountsCurrentMembers",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountMemberListResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List selected account members",
        "tags": [
          "Accounts"
        ]
      },
      "post": {
        "description": "Adds a registered user to the active account context or updates their role if they already belong to it.",
        "operationId": "postAccountsCurrentMembers",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddAccountMemberRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountMemberResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "412": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Precondition Failed"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Add a member to the selected account",
        "tags": [
          "Accounts"
        ]
      }
    },
    "/v1/accounts/current/members/{userID}": {
      "patch": {
        "description": "Updates the role of an existing user within the active account context.",
        "operationId": "patchAccountsCurrentMembersByUserID",
        "parameters": [
          {
            "description": "User ID",
            "in": "path",
            "name": "userID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAccountMemberRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountMemberResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "412": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Precondition Failed"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Update a selected account member role",
        "tags": [
          "Accounts"
        ]
      }
    },
    "/v1/agent/chat": {
      "post": {
        "description": "Stream an agent conversation over server-sent events. Messages may include tool calls returned by a previous turn.",
        "operationId": "post_v1_agent_chat",
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "messages": [
                  {
                    "content": "How do I deploy a model?",
                    "role": "user"
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "text/event-stream": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "Server-sent event stream"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Chat with the agent",
        "tags": [
          "Agent"
        ]
      }
    },
    "/v1/api-keys": {
      "get": {
        "description": "Returns the API keys issued for the active account context.",
        "operationId": "getApiKeys",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKeyListResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List API keys for the selected account",
        "tags": [
          "API Keys"
        ]
      },
      "post": {
        "description": "Issues a new API key for the active account context and returns the plaintext key once.",
        "operationId": "postApiKeys",
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKeyResponse"
                }
              }
            },
            "description": "Created"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create an API key for the selected account",
        "tags": [
          "API Keys"
        ]
      }
    },
    "/v1/api-keys/{keyID}/revoke": {
      "post": {
        "description": "Revokes an API key issued for the active account context.",
        "operationId": "postApiKeysKeyIDRevoke",
        "parameters": [
          {
            "description": "API key ID",
            "in": "path",
            "name": "keyID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Revoke an API key",
        "tags": [
          "API Keys"
        ]
      }
    },
    "/v1/audio/speech": {
      "post": {
        "description": "Generates audio from text. Accepts Bearer access tokens or API keys.",
        "operationId": "postV1AudioSpeech",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AudioSpeechRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "Audio bytes"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "OpenAI-compatible audio speech (TTS)",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/audio/transcriptions": {
      "post": {
        "description": "Transcribes an uploaded audio file. Accepts Bearer access tokens or API keys. Handles POST /v1/audio/transcriptions (multipart/form-data).",
        "operationId": "postV1AudioTranscriptions",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "properties": {
                  "file": {
                    "description": "Audio file",
                    "format": "binary",
                    "type": "string"
                  },
                  "language": {
                    "description": "Source language",
                    "type": "string"
                  },
                  "model": {
                    "description": "Model ID",
                    "type": "string"
                  },
                  "response_format": {
                    "description": "Response format",
                    "type": "string"
                  }
                },
                "required": [
                  "model",
                  "file"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "type": "string"
                  },
                  "type": "object"
                }
              }
            },
            "description": "Transcription text"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "OpenAI-compatible audio transcription (STT)",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/audio/voices": {
      "get": {
        "description": "Lists available TTS voices and supported languages for a model. Accepts Bearer access tokens or API keys.",
        "operationId": "getV1AudioVoices",
        "parameters": [
          {
            "description": "Model ID",
            "in": "query",
            "name": "model",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "voices and languages"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "List available audio voices for a model",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/audit": {
      "get": {
        "description": "List audit events for the authenticated account with optional filters.",
        "operationId": "get_v1_audit",
        "parameters": [
          {
            "description": "Filter by user ID",
            "in": "query",
            "name": "user_id",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter by semantic action",
            "in": "query",
            "name": "action",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter by HTTP method",
            "in": "query",
            "name": "method",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter by route path",
            "in": "query",
            "name": "path",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "RFC3339 lower time bound",
            "in": "query",
            "name": "from",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "RFC3339 upper time bound",
            "in": "query",
            "name": "to",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter by HTTP status code",
            "in": "query",
            "name": "status",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Maximum number of events",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "description": "Pagination offset",
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "events": [
                    {
                      "action": "instances.start",
                      "created_at": "2026-01-15T10:00:00Z",
                      "id": "audit_xxx",
                      "method": "POST",
                      "path": "/v1/instances/{instanceID}/start",
                      "status_code": 200
                    }
                  ]
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List audit events",
        "tags": [
          "Audit"
        ]
      }
    },
    "/v1/auth/forgot-password": {
      "post": {
        "description": "Always returns 200 with a generic message to avoid user enumeration.",
        "operationId": "postAuthForgotPassword",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ForgotPasswordRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ForgotPasswordResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "summary": "Request a password reset email",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/legal-acceptances": {
      "post": {
        "description": "Appends server-validated legal acceptance evidence for the authenticated user.",
        "operationId": "postAuthLegalAcceptances",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LegalAcceptanceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "No Content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Record current legal acceptances",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/login": {
      "post": {
        "description": "Authenticates a user with email and password. If verification is required, the JSON response may include a next_step. Only successful authentication sets the HTTP-only qdiv0_access and qdiv0_refresh browser-session cookies; the JSON response contains no access or refresh token values.",
        "operationId": "postAuthLogin",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LoginRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LoginResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "summary": "Authenticate a user",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/login/resend": {
      "post": {
        "description": "Revalidates the supplied password and sends a fresh sign-in email when the account uses email sign-in verification. The response is intentionally generic.",
        "operationId": "postAuthLoginResend",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResendLoginEmailRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResendEmailResponse"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Too Many Requests"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "summary": "Resend a password sign-in email",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/logout": {
      "post": {
        "description": "Clear the HTTP-only qdiv0_access and qdiv0_refresh browser-session cookies.",
        "operationId": "post_v1_auth_logout",
        "responses": {
          "204": {
            "description": "No Content"
          }
        },
        "summary": "Log out",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/me": {
      "get": {
        "description": "Resolves the user attached to the bearer token.",
        "operationId": "getAuthMe",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserInfoResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Return the current authenticated user",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/oauth/identities": {
      "get": {
        "description": "Returns the authenticated user's linked providers without exposing secrets.",
        "operationId": "getAuthOauthIdentities",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List linked OAuth identities",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/oauth/identities/{provider}": {
      "delete": {
        "description": "Removes a provider identity. The auth service enforces the last-access-method invariant.",
        "operationId": "deleteAuthOauthIdentitiesProvider",
        "parameters": [
          {
            "description": "OAuth provider",
            "in": "path",
            "name": "provider",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "No Content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Unlink an OAuth identity",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/oauth/signup": {
      "post": {
        "description": "Completes an OAuth-only signup with the continuation token and legal acceptance payload, then sets the browser session.",
        "operationId": "postAuthOauthSignup",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OauthSignupRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "summary": "Complete OAuth signup",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/oauth/totp": {
      "post": {
        "description": "Redeems a totp_required continuation and sets the browser session.",
        "operationId": "postAuthOauthTotp",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OauthTOTPRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "summary": "Complete OAuth TOTP challenge",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/oauth/{provider}/begin": {
      "get": {
        "description": "Redirects the browser to the selected provider. The optional redirect URI must be allowlisted by the auth service.",
        "operationId": "getAuthOauthProviderBegin",
        "parameters": [
          {
            "description": "OAuth provider",
            "in": "path",
            "name": "provider",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Optional allowlisted callback URI",
            "in": "query",
            "name": "redirect_uri",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "302": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "Provider authorization redirect"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Too Many Requests"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "summary": "Start OAuth sign-in",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/oauth/{provider}/callback": {
      "get": {
        "description": "Exchanges the provider authorization code and redirects to the frontend. Tokens are stored in HttpOnly cookies or a continuation is returned in the URL fragment.",
        "operationId": "getAuthOauthProviderCallback",
        "parameters": [
          {
            "description": "OAuth provider",
            "in": "path",
            "name": "provider",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Provider authorization code",
            "in": "query",
            "name": "code",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "OAuth state",
            "in": "query",
            "name": "state",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Provider error",
            "in": "query",
            "name": "error",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "302": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "Frontend redirect"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "summary": "Finish OAuth callback",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/oauth/{provider}/link": {
      "post": {
        "description": "Redirects an authenticated user to the selected provider to link that identity.",
        "operationId": "postAuthOauthProviderLink",
        "parameters": [
          {
            "description": "OAuth provider",
            "in": "path",
            "name": "provider",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "302": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "Provider authorization redirect"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Too Many Requests"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Link an OAuth provider",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/passkeys": {
      "get": {
        "description": "Returns the current user's passkey credentials.",
        "operationId": "getAuthPasskeys",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PasskeyListResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List passkeys",
        "tags": [
          "Auth"
        ]
      },
      "post": {
        "description": "Stores a passkey credential for the authenticated user.",
        "operationId": "postAuthPasskeys",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterPasskeyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "No Content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Register a passkey",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/passkeys/begin-login": {
      "post": {
        "description": "Creates a passkey login challenge for the provided email.",
        "operationId": "postAuthPasskeysBeginLogin",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BeginPasskeyloginRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BeginPasskeyloginResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Service Unavailable"
          }
        },
        "summary": "Begin passkey login",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/passkeys/begin-registration": {
      "post": {
        "description": "Creates a passkey registration challenge for the authenticated user.",
        "operationId": "postAuthPasskeysBeginRegistration",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BeginPasskeyRegistrationResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Begin passkey registration",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/passkeys/finish-login": {
      "post": {
        "description": "Consumes a passkey login challenge and returns a session.",
        "operationId": "postAuthPasskeysFinishLogin",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FinishPasskeyloginRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FinishPasskeyloginResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "summary": "Finish passkey login",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/passkeys/finish-registration": {
      "post": {
        "description": "Consumes a passkey registration challenge and stores the credential.",
        "operationId": "postAuthPasskeysFinishRegistration",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FinishPasskeyRegistrationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "No Content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Finish passkey registration",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/passkeys/{credentialID}": {
      "delete": {
        "description": "Deletes a passkey credential from the authenticated user.",
        "operationId": "deleteAuthPasskeys",
        "parameters": [
          {
            "description": "Passkey credential ID",
            "in": "path",
            "name": "credentialID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "No Content"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Remove a passkey",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/password": {
      "patch": {
        "description": "Requires the authenticated user to provide the current password and a new password.",
        "operationId": "patchAuthPassword",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangePasswordRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "No Content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Change the current user's password",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/preferences": {
      "get": {
        "description": "Returns the per-user security toggles for the authenticated user.",
        "operationId": "getAuthPreferences",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserPreferencesResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get the current user's security preferences",
        "tags": [
          "Auth"
        ]
      },
      "patch": {
        "description": "Partial update of the per-user security toggles. Only fields present in the body are applied.",
        "operationId": "patchAuthPreferences",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePreferencesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "No Content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Update the current user's security preferences",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/private-beta/check": {
      "get": {
        "description": "Check whether the request is allowed to use private-beta routes. When private-beta protection is disabled, the endpoint returns 204.",
        "operationId": "get_v1_auth_private_beta_check",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "summary": "Check private beta access",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/refresh": {
      "post": {
        "description": "Consumes the HTTP-only qdiv0_refresh cookie and, on success, resets the qdiv0_access and qdiv0_refresh browser-session cookies. The endpoint has no JSON request body and the JSON response contains no access or refresh token values.",
        "operationId": "postAuthRefresh",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RefreshResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "summary": "Refresh the browser session",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/register": {
      "post": {
        "description": "Creates a pending account using email and password credentials. Email verification is required; registration does not issue session tokens or cookies, and the JSON response contains no access or refresh token values.",
        "operationId": "postAuthRegister",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterResponse"
                }
              }
            },
            "description": "Created"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Conflict"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "summary": "Register a new user",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/resend-activation": {
      "post": {
        "description": "Replaces the activation link for an eligible pending account. The response is intentionally generic.",
        "operationId": "postAuthActivationResend",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResendActivationEmailRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResendEmailResponse"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Too Many Requests"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "summary": "Resend an activation email",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/reset-password": {
      "post": {
        "description": "Consumes the reset token, updates the password, and returns a fresh session.",
        "operationId": "postAuthResetPassword",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResetPasswordRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResetPasswordResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "summary": "Reset a password using a one-time token",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/totp": {
      "delete": {
        "description": "Removes the current user's TOTP credential.",
        "operationId": "deleteAuthTotp",
        "responses": {
          "204": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "No Content"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Disable TOTP",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/totp/begin": {
      "post": {
        "description": "Returns a new TOTP secret and otpauth URI for the authenticated user.",
        "operationId": "postAuthTotpBegin",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BeginTotpEnrollmentResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Start TOTP enrollment",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/totp/confirm": {
      "post": {
        "description": "Stores a TOTP secret for the authenticated user after verifying the code.",
        "operationId": "postAuthTotpConfirm",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ConfirmTotpEnrollmentRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "No Content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Confirm TOTP enrollment",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/trusted-browsers": {
      "delete": {
        "description": "Revokes every trusted-browser token for the authenticated user and clears the current browser cookie.",
        "operationId": "deleteAuthTrustedBrowsers",
        "responses": {
          "204": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "No Content"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Revoke trusted browsers",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/auth/verify-email": {
      "get": {
        "description": "Consumes the activation token and returns a session.",
        "operationId": "getAuthVerifyEmail",
        "parameters": [
          {
            "description": "Activation token from the email",
            "in": "query",
            "name": "token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VerifyEmailResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "summary": "Verify an email activation link",
        "tags": [
          "Auth"
        ]
      }
    },
    "/v1/automations": {
      "get": {
        "description": "List automations belonging to the current account.",
        "operationId": "get_v1_automations",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "automations": [
                    {
                      "config_json": "{}",
                      "id": "automation_xxx",
                      "input_connector_id": "connector_in",
                      "name": "Support triage",
                      "output_connector_id": "connector_out",
                      "processor_ref": "endpoint_xxx",
                      "processor_type": "agent",
                      "status": "active"
                    }
                  ]
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List automations",
        "tags": [
          "Automations"
        ]
      },
      "post": {
        "description": "Create an account-scoped automation connecting input, processor, and output resources.",
        "operationId": "post_v1_automations",
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "config_json": "{}",
                "input_connector_id": "connector_in",
                "name": "Support triage",
                "output_connector_id": "connector_out",
                "processor_ref": "endpoint_xxx",
                "processor_type": "agent"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "example": {
                  "config_json": "{}",
                  "id": "automation_xxx",
                  "input_connector_id": "connector_in",
                  "name": "Support triage",
                  "output_connector_id": "connector_out",
                  "processor_ref": "endpoint_xxx",
                  "processor_type": "agent",
                  "status": "active"
                }
              }
            },
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create automation",
        "tags": [
          "Automations"
        ]
      }
    },
    "/v1/automations/types": {
      "get": {
        "description": "List automation processor types supported by the platform.",
        "operationId": "get_v1_automations_types",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "types": [
                    {
                      "display_name": "Agent",
                      "type": "agent"
                    }
                  ]
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List automation types",
        "tags": [
          "Automations"
        ]
      }
    },
    "/v1/automations/{automationID}": {
      "delete": {
        "description": "Delete an account-scoped automation.",
        "operationId": "delete_v1_automations_automationID",
        "parameters": [
          {
            "description": "Automation ID",
            "in": "path",
            "name": "automationID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Delete automation",
        "tags": [
          "Automations"
        ]
      },
      "get": {
        "description": "Get an account-scoped automation by ID.",
        "operationId": "get_v1_automations_automationID",
        "parameters": [
          {
            "description": "Automation ID",
            "in": "path",
            "name": "automationID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "config_json": "{}",
                  "id": "automation_xxx",
                  "input_connector_id": "connector_in",
                  "name": "Support triage",
                  "output_connector_id": "connector_out",
                  "processor_ref": "endpoint_xxx",
                  "processor_type": "agent",
                  "status": "active"
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get automation",
        "tags": [
          "Automations"
        ]
      },
      "patch": {
        "description": "Update an account-scoped automation.",
        "operationId": "patch_v1_automations_automationID",
        "parameters": [
          {
            "description": "Automation ID",
            "in": "path",
            "name": "automationID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "config_json": "{}",
                "input_connector_id": "connector_in",
                "name": "Support triage",
                "output_connector_id": "connector_out",
                "processor_ref": "endpoint_xxx",
                "processor_type": "agent"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "config_json": "{}",
                  "id": "automation_xxx",
                  "input_connector_id": "connector_in",
                  "name": "Support triage",
                  "output_connector_id": "connector_out",
                  "processor_ref": "endpoint_xxx",
                  "processor_type": "agent",
                  "status": "active"
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Update automation",
        "tags": [
          "Automations"
        ]
      }
    },
    "/v1/automations/{automationID}/pause": {
      "post": {
        "description": "Pause an active automation.",
        "operationId": "post_v1_automations_automationID_pause",
        "parameters": [
          {
            "description": "Automation ID",
            "in": "path",
            "name": "automationID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "config_json": "{}",
                  "id": "automation_xxx",
                  "input_connector_id": "connector_in",
                  "name": "Support triage",
                  "output_connector_id": "connector_out",
                  "processor_ref": "endpoint_xxx",
                  "processor_type": "agent",
                  "status": "active"
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Pause automation",
        "tags": [
          "Automations"
        ]
      }
    },
    "/v1/automations/{automationID}/resume": {
      "post": {
        "description": "Resume a paused automation.",
        "operationId": "post_v1_automations_automationID_resume",
        "parameters": [
          {
            "description": "Automation ID",
            "in": "path",
            "name": "automationID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "config_json": "{}",
                  "id": "automation_xxx",
                  "input_connector_id": "connector_in",
                  "name": "Support triage",
                  "output_connector_id": "connector_out",
                  "processor_ref": "endpoint_xxx",
                  "processor_type": "agent",
                  "status": "active"
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Resume automation",
        "tags": [
          "Automations"
        ]
      }
    },
    "/v1/automations/{automationID}/validate": {
      "post": {
        "description": "Validate an automation's connector and processor configuration.",
        "operationId": "post_v1_automations_automationID_validate",
        "parameters": [
          {
            "description": "Automation ID",
            "in": "path",
            "name": "automationID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "valid": true
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Validate automation",
        "tags": [
          "Automations"
        ]
      }
    },
    "/v1/billing/balance": {
      "get": {
        "description": "Returns the billing balance of the authenticated account.",
        "operationId": "getBillingBalance",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountBalanceResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get the current account balance",
        "tags": [
          "Billing"
        ]
      }
    },
    "/v1/billing/checkout": {
      "post": {
        "description": "Creates a billing checkout session for the authenticated account.",
        "operationId": "postBillingCheckout",
        "parameters": [
          {
            "description": "Checkout idempotency key",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckoutSessionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CheckoutSessionResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Conflict"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create a checkout session",
        "tags": [
          "Billing"
        ]
      }
    },
    "/v1/billing/debit": {
      "post": {
        "description": "Debits a positive amount from the authenticated account.",
        "operationId": "postBillingDebit",
        "parameters": [
          {
            "description": "Debit idempotency key",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DebitBalanceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DebitBalanceResponse"
                }
              }
            },
            "description": "OK"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QueuedDebitResponse"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Conflict"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Service Unavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Debit the current account balance",
        "tags": [
          "Billing"
        ]
      }
    },
    "/v1/billing/debit/operations/{operationID}": {
      "get": {
        "description": "",
        "operationId": "getBillingDebitOperation",
        "parameters": [
          {
            "description": "Debit operation ID",
            "in": "path",
            "name": "operationID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DebitOperationResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Service Unavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get a debit operation",
        "tags": [
          "Billing"
        ]
      }
    },
    "/v1/billing/ledger": {
      "get": {
        "description": "Returns ledger movements for the authenticated account.",
        "operationId": "getBillingLedger",
        "parameters": [
          {
            "description": "Maximum number of entries",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 20,
              "type": "integer"
            }
          },
          {
            "description": "Number of entries to skip",
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LedgerHistoryResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List ledger entries",
        "tags": [
          "Billing"
        ]
      }
    },
    "/v1/billing/payments": {
      "get": {
        "description": "Returns the payment history for the active account context.",
        "operationId": "getBillingPayments",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentsResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List payments for the authenticated account",
        "tags": [
          "Billing"
        ]
      }
    },
    "/v1/billing/payments/{paymentID}/invoice.pdf": {
      "get": {
        "description": "Returns the invoice PDF for a given payment of the active account context.",
        "operationId": "getBillingPaymentsPaymentIDInvoicePDF",
        "parameters": [
          {
            "description": "Payment ID",
            "in": "path",
            "name": "paymentID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/pdf": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Download a payment invoice PDF",
        "tags": [
          "Billing"
        ]
      }
    },
    "/v1/biomolecular/capabilities": {
      "get": {
        "description": "",
        "operationId": "getV1BiomolecularCapabilities",
        "parameters": [
          {
            "description": "Account-owned serving name or instance UUID",
            "in": "query",
            "name": "model",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BiomolecularCapabilities"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Service Unavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Check operator MSA connectivity without starting a GPU instance",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/biomolecular/jobs": {
      "post": {
        "description": "Validated native version-1 Boltz input, up to 32 text attachments (8 MiB), 32 chains and 4096 polymer residues. Account-scoped idempotency. Eight nonterminal jobs per account; one prediction per instance. Terminal results/artifacts expire after seven days.",
        "operationId": "postV1BiomolecularJob",
        "parameters": [
          {
            "description": "Account-scoped request identity",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Service.BiomolecularSubmitRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Service.BiomolecularJobResult"
                }
              }
            },
            "description": "Accepted",
            "headers": {
              "Location": {
                "description": "Job status URL",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Conflict"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Request Entity Too Large"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unsupported Media Type"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Too Many Requests"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Service Unavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Submit a durable Boltz prediction job",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/biomolecular/jobs/{job_id}": {
      "get": {
        "description": "",
        "operationId": "getV1BiomolecularJob",
        "parameters": [
          {
            "description": "Job UUID",
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Service.BiomolecularJobResult"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Service Unavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Read an account-owned Boltz job",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/biomolecular/jobs/{job_id}/artifacts/{artifact_id}": {
      "get": {
        "description": "Bounded binary stream, available independently of the original instance for seven days after job completion.",
        "operationId": "downloadV1BiomolecularArtifact",
        "parameters": [
          {
            "description": "Job UUID",
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Artifact UUID",
            "in": "path",
            "name": "artifact_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Service Unavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Download a persisted Boltz artifact",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/biomolecular/jobs/{job_id}/cancel": {
      "post": {
        "description": "",
        "operationId": "cancelV1BiomolecularJob",
        "parameters": [
          {
            "description": "Job UUID",
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Service.BiomolecularJobResult"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Service Unavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Request idempotent Boltz job cancellation",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/chat/completions": {
      "post": {
        "description": "Executes a chat completion using a managed instance or public model. Accepts Bearer access tokens or API keys. Supports streaming (SSE) when \"stream\": true.",
        "operationId": "postV1ChatCompletions",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChatRequestEnvelope"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OpenAI chat.completion response or SSE stream"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "firewall blocked"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "OpenAI-compatible chat completions",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/connectors": {
      "get": {
        "description": "List connectors belonging to the current account.",
        "operationId": "get_v1_connectors",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "connectors": [
                    {
                      "config_json": "{\"chat_id\":\"123\"}",
                      "id": "connector_xxx",
                      "name": "Support Telegram",
                      "status": "active",
                      "type": "telegram"
                    }
                  ]
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List connectors",
        "tags": [
          "Connectors"
        ]
      },
      "post": {
        "description": "Create an account-scoped connector.",
        "operationId": "post_v1_connectors",
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "bot_token": "bot-token",
                "config_json": "{\"chat_id\":\"123\"}",
                "name": "Support Telegram",
                "type": "telegram"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "example": {
                  "config_json": "{\"chat_id\":\"123\"}",
                  "id": "connector_xxx",
                  "name": "Support Telegram",
                  "status": "active",
                  "type": "telegram"
                }
              }
            },
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create connector",
        "tags": [
          "Connectors"
        ]
      }
    },
    "/v1/connectors/types": {
      "get": {
        "description": "List connector types supported by the platform.",
        "operationId": "get_v1_connectors_types",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "types": [
                    {
                      "display_name": "Telegram",
                      "type": "telegram"
                    }
                  ]
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List connector types",
        "tags": [
          "Connectors"
        ]
      }
    },
    "/v1/connectors/{connectorID}": {
      "delete": {
        "description": "Delete an account-scoped connector.",
        "operationId": "delete_v1_connectors_connectorID",
        "parameters": [
          {
            "description": "Connector ID",
            "in": "path",
            "name": "connectorID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Delete connector",
        "tags": [
          "Connectors"
        ]
      },
      "get": {
        "description": "Get an account-scoped connector by ID.",
        "operationId": "get_v1_connectors_connectorID",
        "parameters": [
          {
            "description": "Connector ID",
            "in": "path",
            "name": "connectorID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "config_json": "{\"chat_id\":\"123\"}",
                  "id": "connector_xxx",
                  "name": "Support Telegram",
                  "status": "active",
                  "type": "telegram"
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get connector",
        "tags": [
          "Connectors"
        ]
      },
      "patch": {
        "description": "Update an account-scoped connector configuration.",
        "operationId": "patch_v1_connectors_connectorID",
        "parameters": [
          {
            "description": "Connector ID",
            "in": "path",
            "name": "connectorID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "config_json": "{\"chat_id\":\"456\"}",
                "name": "Updated Telegram",
                "type": "telegram"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "config_json": "{\"chat_id\":\"123\"}",
                  "id": "connector_xxx",
                  "name": "Support Telegram",
                  "status": "active",
                  "type": "telegram"
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Update connector",
        "tags": [
          "Connectors"
        ]
      }
    },
    "/v1/connectors/{connectorID}/access-requests": {
      "get": {
        "description": "List access requests for a connector.",
        "operationId": "get_v1_connectors_connectorID_access_requests",
        "parameters": [
          {
            "description": "Connector ID",
            "in": "path",
            "name": "connectorID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "requests": [
                    {
                      "connector_id": "connector_xxx",
                      "created_at": "2026-01-15T10:00:00Z",
                      "id": "request_xxx",
                      "status": "pending"
                    }
                  ]
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List connector access requests",
        "tags": [
          "Connectors"
        ]
      }
    },
    "/v1/connectors/{connectorID}/access-requests/{requestID}/approve": {
      "post": {
        "description": "Approve a pending connector access request.",
        "operationId": "post_v1_connectors_connectorID_access_requests_requestID_approve",
        "parameters": [
          {
            "description": "Connector ID",
            "in": "path",
            "name": "connectorID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Access request ID",
            "in": "path",
            "name": "requestID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {}
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Approve connector access request",
        "tags": [
          "Connectors"
        ]
      }
    },
    "/v1/connectors/{connectorID}/access-requests/{requestID}/reject": {
      "post": {
        "description": "Reject a pending connector access request.",
        "operationId": "post_v1_connectors_connectorID_access_requests_requestID_reject",
        "parameters": [
          {
            "description": "Connector ID",
            "in": "path",
            "name": "connectorID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Access request ID",
            "in": "path",
            "name": "requestID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {}
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Reject connector access request",
        "tags": [
          "Connectors"
        ]
      }
    },
    "/v1/connectors/{connectorID}/pause": {
      "post": {
        "description": "Pause a connector without deleting its configuration.",
        "operationId": "post_v1_connectors_connectorID_pause",
        "parameters": [
          {
            "description": "Connector ID",
            "in": "path",
            "name": "connectorID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "config_json": "{\"chat_id\":\"123\"}",
                  "id": "connector_xxx",
                  "name": "Support Telegram",
                  "status": "active",
                  "type": "telegram"
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Pause connector",
        "tags": [
          "Connectors"
        ]
      }
    },
    "/v1/connectors/{connectorID}/principals": {
      "get": {
        "description": "List active principals associated with a connector.",
        "operationId": "get_v1_connectors_connectorID_principals",
        "parameters": [
          {
            "description": "Connector ID",
            "in": "path",
            "name": "connectorID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "principals": [
                    {
                      "active": true,
                      "connector_id": "connector_xxx",
                      "display_name": "Support Bot",
                      "id": "principal_xxx"
                    }
                  ]
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List connector principals",
        "tags": [
          "Connectors"
        ]
      }
    },
    "/v1/connectors/{connectorID}/resume": {
      "post": {
        "description": "Resume a paused connector.",
        "operationId": "post_v1_connectors_connectorID_resume",
        "parameters": [
          {
            "description": "Connector ID",
            "in": "path",
            "name": "connectorID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "config_json": "{\"chat_id\":\"123\"}",
                  "id": "connector_xxx",
                  "name": "Support Telegram",
                  "status": "active",
                  "type": "telegram"
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Resume connector",
        "tags": [
          "Connectors"
        ]
      }
    },
    "/v1/connectors/{connectorID}/rotate-webhook": {
      "post": {
        "description": "Rotate the webhook credentials for a connector.",
        "operationId": "post_v1_connectors_connectorID_rotate_webhook",
        "parameters": [
          {
            "description": "Connector ID",
            "in": "path",
            "name": "connectorID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "config_json": "{\"chat_id\":\"123\"}",
                  "id": "connector_xxx",
                  "name": "Support Telegram",
                  "status": "active",
                  "type": "telegram"
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Rotate connector webhook",
        "tags": [
          "Connectors"
        ]
      }
    },
    "/v1/connectors/{connectorID}/verify": {
      "post": {
        "description": "Verify that a connector can reach its provider.",
        "operationId": "post_v1_connectors_connectorID_verify",
        "parameters": [
          {
            "description": "Connector ID",
            "in": "path",
            "name": "connectorID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "config_json": "{\"chat_id\":\"123\"}",
                  "id": "connector_xxx",
                  "name": "Support Telegram",
                  "status": "active",
                  "type": "telegram"
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Verify connector",
        "tags": [
          "Connectors"
        ]
      }
    },
    "/v1/embeddings": {
      "post": {
        "description": "Generates embeddings for a text or multimodal input. Accepts Bearer access tokens or API keys.",
        "operationId": "postV1Embeddings",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EmbeddingsRequestEnvelope"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OpenAI embeddings list response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "OpenAI-compatible embeddings",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/firewall-rules": {
      "get": {
        "description": "Returns all firewall rules for the authenticated account.",
        "operationId": "getFirewallRules",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/FirewallRuleResponse"
                  },
                  "type": "array"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List firewall rules",
        "tags": [
          "Firewall Rules"
        ]
      },
      "post": {
        "description": "Creates a new firewall rule for the authenticated account.",
        "operationId": "postFirewallRule",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateFirewallRuleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FirewallRuleResponse"
                }
              }
            },
            "description": "Created"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Conflict"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create a firewall rule",
        "tags": [
          "Firewall Rules"
        ]
      }
    },
    "/v1/firewall-rules/{ruleSlug}": {
      "delete": {
        "description": "Removes a firewall rule by slug.",
        "operationId": "deleteFirewallRule",
        "parameters": [
          {
            "description": "Firewall rule slug",
            "in": "path",
            "name": "ruleSlug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "type": "boolean"
                  },
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Delete a firewall rule",
        "tags": [
          "Firewall Rules"
        ]
      },
      "get": {
        "description": "Returns a single firewall rule by slug.",
        "operationId": "getFirewallRule",
        "parameters": [
          {
            "description": "Firewall rule slug",
            "in": "path",
            "name": "ruleSlug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FirewallRuleResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get a firewall rule",
        "tags": [
          "Firewall Rules"
        ]
      },
      "patch": {
        "description": "Partially updates a firewall rule by slug.",
        "operationId": "patchFirewallRule",
        "parameters": [
          {
            "description": "Firewall rule slug",
            "in": "path",
            "name": "ruleSlug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateFirewallRuleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FirewallRuleResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Update a firewall rule",
        "tags": [
          "Firewall Rules"
        ]
      }
    },
    "/v1/firewall-rules/{ruleSlug}:evaluate": {
      "post": {
        "description": "Runs input against a single firewall rule and returns the evaluation result.",
        "operationId": "postFirewallRuleEvaluate",
        "parameters": [
          {
            "description": "Firewall rule slug",
            "in": "path",
            "name": "ruleSlug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FirewallRuleEvaluationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FirewallEvaluationResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Evaluate a firewall rule",
        "tags": [
          "Firewall Rules"
        ]
      }
    },
    "/v1/firewalls": {
      "get": {
        "description": "Returns all firewalls for the authenticated account.",
        "operationId": "getFirewalls",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/FirewallResponse"
                  },
                  "type": "array"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List firewalls",
        "tags": [
          "Firewalls"
        ]
      },
      "post": {
        "description": "Creates a new firewall for the authenticated account.",
        "operationId": "postFirewall",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateFirewallRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FirewallResponse"
                }
              }
            },
            "description": "Created"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Conflict"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create a firewall",
        "tags": [
          "Firewalls"
        ]
      }
    },
    "/v1/firewalls/{firewallSlug}": {
      "delete": {
        "description": "Removes a firewall by slug.",
        "operationId": "deleteFirewall",
        "parameters": [
          {
            "description": "Firewall slug",
            "in": "path",
            "name": "firewallSlug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "type": "boolean"
                  },
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Delete a firewall",
        "tags": [
          "Firewalls"
        ]
      },
      "get": {
        "description": "Returns a single firewall by slug.",
        "operationId": "getFirewall",
        "parameters": [
          {
            "description": "Firewall slug",
            "in": "path",
            "name": "firewallSlug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FirewallResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get a firewall",
        "tags": [
          "Firewalls"
        ]
      },
      "patch": {
        "description": "Partially updates a firewall by slug.",
        "operationId": "patchFirewall",
        "parameters": [
          {
            "description": "Firewall slug",
            "in": "path",
            "name": "firewallSlug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateFirewallRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FirewallResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Update a firewall",
        "tags": [
          "Firewalls"
        ]
      }
    },
    "/v1/firewalls/{firewallSlug}:evaluate": {
      "post": {
        "description": "Runs input against a firewall and returns the evaluation result.",
        "operationId": "postFirewallEvaluate",
        "parameters": [
          {
            "description": "Firewall slug",
            "in": "path",
            "name": "firewallSlug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FirewallEvaluationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FirewallEvaluationResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Evaluate a firewall",
        "tags": [
          "Firewalls"
        ]
      }
    },
    "/v1/flexible-vector-databases": {
      "get": {
        "description": "Returns the vector databases owned by the authenticated account.",
        "operationId": "getVectorDatabases",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VectorDatabaseResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List vector databases",
        "tags": [
          "Vector Databases"
        ]
      },
      "post": {
        "description": "Creates a new vector database for the authenticated account.",
        "operationId": "postVectorDatabases",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateVectorDatabaseRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VectorDatabaseResponse"
                }
              }
            },
            "description": "Created"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create a vector database",
        "tags": [
          "Vector Databases"
        ]
      }
    },
    "/v1/flexible-vector-databases/{databaseID}": {
      "delete": {
        "description": "Removes a vector database owned by the authenticated account.",
        "operationId": "deleteVectorDatabase",
        "parameters": [
          {
            "description": "Vector database ID",
            "in": "path",
            "name": "databaseID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "type": "boolean"
                  },
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Delete a vector database",
        "tags": [
          "Vector Databases"
        ]
      },
      "get": {
        "description": "Returns a single vector database owned by the authenticated account.",
        "operationId": "getVectorDatabase",
        "parameters": [
          {
            "description": "Vector database ID",
            "in": "path",
            "name": "databaseID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VectorDatabaseResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get a vector database",
        "tags": [
          "Vector Databases"
        ]
      },
      "patch": {
        "description": "Updates the slug, name, or description of an existing vector database.",
        "operationId": "patchVectorDatabase",
        "parameters": [
          {
            "description": "Vector database ID",
            "in": "path",
            "name": "databaseID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateVectorDatabaseRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VectorDatabaseResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Update a vector database",
        "tags": [
          "Vector Databases"
        ]
      }
    },
    "/v1/flexible-vector-databases/{databaseID}/documents": {
      "get": {
        "description": "Returns documents stored in a vector database with optional pagination.",
        "operationId": "getVectorDatabaseDocuments",
        "parameters": [
          {
            "description": "Vector database ID",
            "in": "path",
            "name": "databaseID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Maximum number of documents to return",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "description": "Pagination cursor from a previous response",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListDocumentsResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List documents in a vector database",
        "tags": [
          "Vector Databases"
        ]
      }
    },
    "/v1/flexible-vector-databases/{databaseID}/index-direct": {
      "post": {
        "description": "Indexes documents into a vector database synchronously.",
        "operationId": "postVectorDatabaseIndexDirect",
        "parameters": [
          {
            "description": "Vector database ID",
            "in": "path",
            "name": "databaseID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IndexDocumentsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "format": "int32",
                    "type": "integer"
                  },
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Index documents directly",
        "tags": [
          "Vector Databases"
        ]
      }
    },
    "/v1/flexible-vector-databases/{databaseID}/index-jobs": {
      "post": {
        "description": "Enqueues documents for asynchronous indexing into a vector database.",
        "operationId": "postVectorDatabaseIndexJobs",
        "parameters": [
          {
            "description": "Vector database ID",
            "in": "path",
            "name": "databaseID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IndexDocumentsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "type": "string"
                  },
                  "type": "object"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Enqueue an index job",
        "tags": [
          "Vector Databases"
        ]
      }
    },
    "/v1/flexible-vector-databases/{databaseID}/index-jobs/{jobID}": {
      "get": {
        "description": "Returns the status of an asynchronous index job.",
        "operationId": "getVectorDatabaseIndexJob",
        "parameters": [
          {
            "description": "Vector database ID",
            "in": "path",
            "name": "databaseID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Index job ID",
            "in": "path",
            "name": "jobID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IndexJobResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get an index job",
        "tags": [
          "Vector Databases"
        ]
      }
    },
    "/v1/flexible-vector-databases/{databaseID}/recommend": {
      "post": {
        "description": "Returns recommended documents for a recommend token.",
        "operationId": "postVectorDatabaseRecommend",
        "parameters": [
          {
            "description": "Vector database ID",
            "in": "path",
            "name": "databaseID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RecommendRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchHitResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Recommend documents",
        "tags": [
          "Vector Databases"
        ]
      }
    },
    "/v1/flexible-vector-databases/{databaseID}/search": {
      "post": {
        "description": "Searches a vector database by query text and/or image URL.",
        "operationId": "postVectorDatabaseSearch",
        "parameters": [
          {
            "description": "Vector database ID",
            "in": "path",
            "name": "databaseID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchHitResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search a vector database",
        "tags": [
          "Vector Databases"
        ]
      }
    },
    "/v1/flexible-vector-databases/{databaseID}/view-element": {
      "post": {
        "description": "Records a view for a document and returns a recommend token.",
        "operationId": "postVectorDatabaseViewElement",
        "parameters": [
          {
            "description": "Vector database ID",
            "in": "path",
            "name": "databaseID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ViewElementRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "type": "string"
                  },
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "View an element",
        "tags": [
          "Vector Databases"
        ]
      }
    },
    "/v1/huggingface/embeddings": {
      "get": {
        "description": "Searches Hugging Face for embedding models.",
        "operationId": "getHuggingfaceEmbeddings",
        "parameters": [
          {
            "description": "Number of models (default 50, max 100)",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "description": "Search query",
            "in": "query",
            "name": "search",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "models": [
                    {
                      "compatibility_reason": "",
                      "compatible": true,
                      "downloads": 800000,
                      "gguf_files": [],
                      "has_gguf": false,
                      "has_safetensors": true,
                      "likes": 900,
                      "pipeline_tag": "feature-extraction",
                      "repo_id": "intfloat/multilingual-e5-large",
                      "tags": [
                        "sentence-transformers"
                      ],
                      "warnings": [],
                      "workload_kind": "embeddings"
                    },
                    {
                      "compatibility_reason": "conflicting-specialized-tags",
                      "compatible": false,
                      "downloads": 600,
                      "gguf_files": [],
                      "has_gguf": false,
                      "has_safetensors": true,
                      "likes": 4,
                      "pipeline_tag": "sentence-similarity",
                      "repo_id": "org/conflicting-embedding",
                      "tags": [
                        "sentence-similarity",
                        "text-to-image"
                      ],
                      "warnings": [],
                      "workload_kind": ""
                    }
                  ]
                },
                "schema": {
                  "$ref": "#/components/schemas/HuggingFaceModelsResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search embedding models",
        "tags": [
          "Models"
        ]
      }
    },
    "/v1/huggingface/files": {
      "get": {
        "description": "Returns GGUF files by default, or compatible YOLO .pt checkpoints when format=yolo. Repository revisions are supported.",
        "operationId": "getHuggingfaceFiles",
        "parameters": [
          {
            "description": "Hugging Face repository ID (e.g. owner/model)",
            "in": "query",
            "name": "repo",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Checkpoint format: gguf (default) or yolo",
            "in": "query",
            "name": "format",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HuggingFaceFilesResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get Hugging Face file sizes",
        "tags": [
          "Models"
        ]
      }
    },
    "/v1/huggingface/models": {
      "get": {
        "description": "Searches Hugging Face for compatible models matching the query.",
        "operationId": "getHuggingfaceModels",
        "parameters": [
          {
            "description": "Search query",
            "in": "query",
            "name": "q",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Number of models (default 100, max 500)",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "description": "Catalog sort order",
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Pagination cursor",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "models": [
                    {
                      "compatibility_reason": "",
                      "compatible": true,
                      "downloads": 500000,
                      "gguf_files": [
                        {
                          "filename": "Qwen3-32B-Q4_K_M.gguf",
                          "quantization": "Q4_K_M",
                          "size_bytes": 21474836480
                        }
                      ],
                      "has_gguf": true,
                      "has_safetensors": true,
                      "likes": 1200,
                      "pipeline_tag": "text-generation",
                      "repo_id": "Qwen/Qwen3-32B",
                      "tags": [
                        "transformers"
                      ],
                      "warnings": [],
                      "workload_kind": "chat"
                    },
                    {
                      "compatibility_reason": "unsupported-task",
                      "compatible": false,
                      "downloads": 1200,
                      "gguf_files": [],
                      "has_gguf": false,
                      "has_safetensors": true,
                      "likes": 8,
                      "pipeline_tag": "text-classification",
                      "repo_id": "org/text-classifier",
                      "tags": [
                        "text-classification"
                      ],
                      "warnings": [
                        "unsupported pipeline task"
                      ],
                      "workload_kind": ""
                    }
                  ]
                },
                "schema": {
                  "$ref": "#/components/schemas/HuggingFaceModelsResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "412": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Precondition Failed"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search Hugging Face models",
        "tags": [
          "Models"
        ]
      }
    },
    "/v1/huggingface/orgs/{org}": {
      "get": {
        "description": "Returns profile information for a Hugging Face organization.",
        "operationId": "getHuggingfaceOrgs",
        "parameters": [
          {
            "description": "Hugging Face organization name",
            "in": "path",
            "name": "org",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HuggingFaceOrgInfoResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get Hugging Face organization info",
        "tags": [
          "Models"
        ]
      }
    },
    "/v1/huggingface/search-tag": {
      "get": {
        "description": "Searches Hugging Face for models matching a query and pipeline tag.",
        "operationId": "getHuggingfaceSearchTag",
        "parameters": [
          {
            "description": "Search query",
            "in": "query",
            "name": "q",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Pipeline tag (e.g. text-generation)",
            "in": "query",
            "name": "pipeline_tag",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Number of models (default 50, max 100)",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HuggingFaceModelsResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search Hugging Face models by tag",
        "tags": [
          "Models"
        ]
      }
    },
    "/v1/huggingface/trending": {
      "get": {
        "description": "Returns trending Hugging Face models.",
        "operationId": "getHuggingfaceTrending",
        "parameters": [
          {
            "description": "Number of models (default 20, max 20)",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "models": [
                    {
                      "compatibility_reason": "",
                      "compatible": true,
                      "downloads": 2000000,
                      "gguf_files": [],
                      "has_gguf": false,
                      "has_safetensors": true,
                      "likes": 3000,
                      "pipeline_tag": "text-generation",
                      "repo_id": "meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8",
                      "tags": [
                        "transformers"
                      ],
                      "warnings": [],
                      "workload_kind": "chat"
                    },
                    {
                      "compatibility_reason": "unsupported-task",
                      "compatible": false,
                      "downloads": 500,
                      "gguf_files": [],
                      "has_gguf": false,
                      "has_safetensors": true,
                      "likes": 2,
                      "pipeline_tag": "text-classification",
                      "repo_id": "org/unsupported-trending",
                      "tags": [
                        "text-classification"
                      ],
                      "warnings": [
                        "unsupported pipeline task"
                      ],
                      "workload_kind": ""
                    }
                  ]
                },
                "schema": {
                  "$ref": "#/components/schemas/HuggingFaceModelsResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Trending Hugging Face models",
        "tags": [
          "Models"
        ]
      }
    },
    "/v1/images/detections": {
      "post": {
        "description": "Detects objects or estimates poses using an existing serving name or running instance UUID. Pose models return boxes with optional keypoints in checkpoint order, each with pixel x/y coordinates and optional confidence (0-1). At most 256 keypoints per detection. PNG/JPEG images up to 16 MiB, dimensions up to 16384 pixels per side and 40 million pixels total. Accepts Bearer access tokens or API keys.",
        "operationId": "postV1ImageDetections",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "properties": {
                  "classes": {
                    "description": "Comma-separated nonnegative class IDs",
                    "type": "string"
                  },
                  "confidence": {
                    "description": "Confidence threshold (0-1, default 0.25)",
                    "type": "number"
                  },
                  "image": {
                    "description": "PNG or JPEG image (maximum 16 MiB)",
                    "format": "binary",
                    "type": "string"
                  },
                  "image_size": {
                    "description": "Inference image size (32-2048, divisible by 32, default 640)",
                    "type": "integer"
                  },
                  "iou": {
                    "description": "IoU threshold (0-1, default 0.7)",
                    "type": "number"
                  },
                  "max_detections": {
                    "description": "Maximum detections (1-1000, default 300)",
                    "type": "integer"
                  },
                  "model": {
                    "description": "Serving name or instance UUID",
                    "type": "string"
                  }
                },
                "required": [
                  "model",
                  "image"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImageDetectionOutput"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Request Entity Too Large"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Service Unavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Detect objects or pose keypoints in an uploaded image",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/images/detections/stream": {
      "get": {
        "description": "Upgrades to a WebSocket and sends session.ready with normalized options and max_frame_bytes. Send optional session.configure JSON options patches and receive session.configured. Binary messages contain one PNG/JPEG image up to 16 MiB, 16384 pixels per side and 40 million pixels total; each returns frame.result with increasing frame_id, processing_ms and the existing typed detection result including optional pose keypoints. Text controls are limited to 32 KiB. Errors contain type, status, optional frame_id and error code/message. One frame executes at a time with at most one pending message; overload closes the session. Inference timeout 60 seconds, idle timeout 90 seconds, session limit 30 minutes. Browser cookies require a configured allowed Origin; native clients use Bearer API keys. account_id is membership-resolved for user credentials and cannot override an account API key. Query credentials are not accepted.",
        "operationId": "getV1ImageDetectionsStream",
        "parameters": [
          {
            "description": "Serving name or instance UUID",
            "in": "query",
            "name": "model",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Preferred account; validated through user membership",
            "in": "query",
            "name": "account_id",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "101": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DetectionStreamEvent"
                }
              }
            },
            "description": "WebSocket upgraded; subsequent text events describe session, frame result or error"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Service Unavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Stream image detection and pose frames over WebSocket",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/images/edits": {
      "post": {
        "description": "Edits an uploaded image using a prompt and optional mask. Accepts Bearer access tokens or API keys.",
        "operationId": "postV1ImageEdits",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "properties": {
                  "guidance_scale": {
                    "description": "Guidance scale (0-20)",
                    "type": "number"
                  },
                  "image": {
                    "description": "Source image file",
                    "format": "binary",
                    "type": "string"
                  },
                  "mask": {
                    "description": "Mask image file",
                    "format": "binary",
                    "type": "string"
                  },
                  "model": {
                    "description": "Model ID",
                    "type": "string"
                  },
                  "num_inference_steps": {
                    "description": "Inference steps (1-200)",
                    "type": "integer"
                  },
                  "prompt": {
                    "description": "Edit prompt",
                    "type": "string"
                  },
                  "seed": {
                    "description": "Random seed",
                    "type": "integer"
                  },
                  "size": {
                    "description": "Output size (WIDTHxHEIGHT)",
                    "type": "string"
                  },
                  "strength": {
                    "description": "Denoising strength (0-1, lower preserves original)",
                    "type": "number"
                  }
                },
                "required": [
                  "model",
                  "prompt",
                  "image"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "Edited images with b64_json data"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "OpenAI-compatible image edits",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/images/generations": {
      "post": {
        "description": "Generates images from a prompt. Accepts Bearer access tokens or API keys.",
        "operationId": "postV1ImageGenerations",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ImageGenerationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OpenAI image generation response with b64_json data"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "OpenAI-compatible image generations",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/instance-config/gpus": {
      "get": {
        "description": "Returns the GPU catalog with pricing, regions, and availability for the authenticated account.",
        "operationId": "getInstanceConfigGpus",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GpuListResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List available GPUs",
        "tags": [
          "Models"
        ]
      }
    },
    "/v1/instances": {
      "get": {
        "description": "",
        "operationId": "getInstances",
        "parameters": [
          {
            "description": "Optional state filter (non_bootstrap, pending, running, stopped, failed)",
            "in": "query",
            "name": "state",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstanceListResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List inference instances",
        "tags": [
          "Instances"
        ]
      },
      "post": {
        "description": "",
        "operationId": "postInstances",
        "parameters": [
          {
            "description": "Optional idempotency key",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateInstanceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstanceResponse"
                }
              }
            },
            "description": "Created"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "402": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Payment Required"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create an inference instance",
        "tags": [
          "Instances"
        ]
      }
    },
    "/v1/instances/preview": {
      "post": {
        "description": "Validate an instance configuration and return the calculated deployment and pricing preview without creating an instance.",
        "operationId": "post_v1_instances_preview",
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "gpu_id": "L40S",
                "huggingface_repo_id": "owner/model-name",
                "runtime_preset": "vllm",
                "scheduling_mode": "manual"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "estimated_price_per_hour_eur": 0.52,
                  "valid": true
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Preview instance",
        "tags": [
          "Instances"
        ]
      }
    },
    "/v1/instances/{instanceID}": {
      "delete": {
        "description": "",
        "operationId": "deleteInstance",
        "parameters": [
          {
            "description": "Instance ID",
            "in": "path",
            "name": "instanceID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Delete an inference instance",
        "tags": [
          "Instances"
        ]
      },
      "get": {
        "description": "",
        "operationId": "getInstanceByID",
        "parameters": [
          {
            "description": "Instance ID",
            "in": "path",
            "name": "instanceID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstanceResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get an inference instance",
        "tags": [
          "Instances"
        ]
      },
      "patch": {
        "description": "",
        "operationId": "patchInstance",
        "parameters": [
          {
            "description": "Instance ID",
            "in": "path",
            "name": "instanceID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateInstanceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstanceResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Update an inference instance",
        "tags": [
          "Instances"
        ]
      }
    },
    "/v1/instances/{instanceID}/preview": {
      "post": {
        "description": "Previews the compatibility and smart selection for an existing instance while applying smart-setting overrides from the request body. Lets the instance settings page fetch the same backend-filtered GPU list used at launch time instead of reimplementing compatibility filtering in the UI.",
        "operationId": "postInstancePreviewUpdate",
        "parameters": [
          {
            "description": "Instance ID",
            "in": "path",
            "name": "instanceID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PreviewInstanceUpdateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PreviewInstanceResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Preview smart selection for an existing instance update",
        "tags": [
          "Instances"
        ]
      }
    },
    "/v1/instances/{instanceID}/schedule-rules": {
      "get": {
        "description": "",
        "operationId": "getInstanceScheduleRules",
        "parameters": [
          {
            "description": "Instance ID",
            "in": "path",
            "name": "instanceID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleRuleListResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List schedule rules for an instance",
        "tags": [
          "Instances"
        ]
      },
      "post": {
        "description": "",
        "operationId": "postInstanceScheduleRule",
        "parameters": [
          {
            "description": "Instance ID",
            "in": "path",
            "name": "instanceID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRuleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleRuleResponse"
                }
              }
            },
            "description": "Created"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create a schedule rule for an instance",
        "tags": [
          "Instances"
        ]
      }
    },
    "/v1/instances/{instanceID}/schedule-rules/{ruleID}": {
      "delete": {
        "description": "",
        "operationId": "deleteInstanceScheduleRule",
        "parameters": [
          {
            "description": "Instance ID",
            "in": "path",
            "name": "instanceID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Schedule rule ID",
            "in": "path",
            "name": "ruleID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Delete a schedule rule for an instance",
        "tags": [
          "Instances"
        ]
      },
      "patch": {
        "description": "",
        "operationId": "patchInstanceScheduleRule",
        "parameters": [
          {
            "description": "Instance ID",
            "in": "path",
            "name": "instanceID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Schedule rule ID",
            "in": "path",
            "name": "ruleID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRuleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleRuleResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Update a schedule rule for an instance",
        "tags": [
          "Instances"
        ]
      }
    },
    "/v1/instances/{instanceID}/shared-capacity": {
      "post": {
        "description": "",
        "operationId": "",
        "parameters": [
          {
            "description": "Instance ID",
            "in": "path",
            "name": "instanceID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Enable idempotency key",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnableSharedCapacityRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedCapacityResponse"
                }
              }
            },
            "description": "OK"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Enable shared capacity for an instance",
        "tags": [
          "Shared Capacity"
        ]
      }
    },
    "/v1/instances/{instanceID}/start": {
      "post": {
        "description": "",
        "operationId": "postInstanceStart",
        "parameters": [
          {
            "description": "Instance ID",
            "in": "path",
            "name": "instanceID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstanceResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Start an inference instance",
        "tags": [
          "Instances"
        ]
      }
    },
    "/v1/instances/{instanceID}/stop": {
      "post": {
        "description": "",
        "operationId": "postInstanceStop",
        "parameters": [
          {
            "description": "Instance ID",
            "in": "path",
            "name": "instanceID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstanceResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Stop an inference instance",
        "tags": [
          "Instances"
        ]
      }
    },
    "/v1/instances/{instanceID}/usage": {
      "get": {
        "description": "",
        "operationId": "getInstanceUsage",
        "parameters": [
          {
            "description": "Instance ID",
            "in": "path",
            "name": "instanceID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Time range (24h, 7d, 30d)",
            "in": "query",
            "name": "range",
            "required": false,
            "schema": {
              "enum": [
                "24h",
                "7d",
                "30d"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstanceUsageResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get an inference instance usage and cost breakdown",
        "tags": [
          "Instances"
        ]
      }
    },
    "/v1/invitations": {
      "get": {
        "description": "Returns invitations pending acceptance that were sent to the authenticated user's email.",
        "operationId": "getInvitations",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InvitationListResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List pending invitations for the authenticated user",
        "tags": [
          "Invitations"
        ]
      }
    },
    "/v1/invitations/accept": {
      "post": {
        "description": "Accepts a pending invitation by token or invitation ID and attaches the authenticated user to the account.",
        "operationId": "postInvitationsAccept",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AcceptInvitationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountMembershipResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Gone"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Accept an invitation",
        "tags": [
          "Invitations"
        ]
      }
    },
    "/v1/models": {
      "get": {
        "description": "OpenAI-compatible model list for the account's enabled serving endpoints. Includes effective context_length and capabilities when known.",
        "operationId": "getV1Models",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": [
                    {
                      "capabilities": [
                        "completion",
                        "tools"
                      ],
                      "context_length": 32768,
                      "created": 0,
                      "id": "my-model",
                      "object": "model",
                      "owned_by": "valendra"
                    }
                  ],
                  "object": "list"
                },
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List available models",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/models/fixed": {
      "get": {
        "description": "Returns the catalog of fixed (curated) models supported by the platform.",
        "operationId": "getModelsFixed",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HuggingFaceModelsResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List fixed models",
        "tags": [
          "Models"
        ]
      }
    },
    "/v1/notifications": {
      "get": {
        "description": "Returns notifications for the authenticated account, newest first.",
        "operationId": "getNotifications",
        "parameters": [
          {
            "description": "Return notifications created after this RFC3339 timestamp",
            "in": "query",
            "name": "since",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Maximum number of notifications to return (default 50, max 100)",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "description": "Filter by notification kind",
            "in": "query",
            "name": "kind",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter by severity",
            "in": "query",
            "name": "severity",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Include already-read notifications",
            "in": "query",
            "name": "include_read",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListNotificationsResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List notifications",
        "tags": [
          "Notifications"
        ]
      }
    },
    "/v1/notifications/dismiss": {
      "post": {
        "description": "Dismisses the given notifications for the authenticated account.",
        "operationId": "postNotificationsDismiss",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DismissRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DismissResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Dismiss notifications",
        "tags": [
          "Notifications"
        ]
      }
    },
    "/v1/notifications/read-all": {
      "post": {
        "description": "Marks all notifications matching the optional filters as read.",
        "operationId": "postNotificationsMarkAllRead",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MarkAllReadRequest"
              }
            }
          },
          "required": false
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MarkAllReadResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Mark all notifications as read",
        "tags": [
          "Notifications"
        ]
      }
    },
    "/v1/notifications/unread-count": {
      "get": {
        "description": "Returns the number of unread notifications for the authenticated account.",
        "operationId": "getNotificationsUnreadCount",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UnreadCountResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get unread notification count",
        "tags": [
          "Notifications"
        ]
      }
    },
    "/v1/notifications/{notificationID}/read": {
      "post": {
        "description": "Marks a single notification as read for the authenticated account.",
        "operationId": "postNotificationsMarkRead",
        "parameters": [
          {
            "description": "Notification ID",
            "in": "path",
            "name": "notificationID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Mark a notification as read",
        "tags": [
          "Notifications"
        ]
      }
    },
    "/v1/prometheus/targets": {
      "get": {
        "description": "Return running inference instances in Prometheus HTTP service-discovery format.",
        "operationId": "getPrometheusTargets",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/HttpTarget"
                  },
                  "type": "array"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing or invalid metrics API key"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "failed to list metrics targets"
          }
        },
        "security": [
          {
            "MetricsAPIKeyAuth": []
          }
        ],
        "summary": "List Prometheus targets",
        "tags": [
          "System"
        ]
      }
    },
    "/v1/prometheus/vllm/metrics": {
      "get": {
        "description": "Proxy an instance's native vLLM Prometheus metrics.",
        "operationId": "getPrometheusVLLMMetrics",
        "parameters": [
          {
            "description": "Inference instance ID",
            "in": "query",
            "name": "instance",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "Prometheus text exposition"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing instance query parameter"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing or invalid metrics API key"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "upstream metrics unavailable"
          }
        },
        "security": [
          {
            "MetricsAPIKeyAuth": []
          }
        ],
        "summary": "Get vLLM Prometheus metrics",
        "tags": [
          "System"
        ]
      }
    },
    "/v1/public/endpoints": {
      "get": {
        "description": "Returns all publicly available model-serving endpoints and their token prices. No authentication required.",
        "operationId": "getV1PublicEndpoints",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicEndpointsResponse"
                }
              }
            },
            "description": "OK"
          }
        },
        "summary": "List public serving endpoints",
        "tags": [
          "Pricing"
        ]
      }
    },
    "/v1/public/model-prices": {
      "get": {
        "description": "Returns provider model pricing for cost comparison. No authentication required.",
        "operationId": "getV1PublicModelPrices",
        "parameters": [
          {
            "description": "Search query for model prices",
            "in": "query",
            "name": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ModelPricesResponse"
                }
              }
            },
            "description": "OK"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Gateway Timeout"
          }
        },
        "summary": "Public model prices",
        "tags": [
          "Pricing"
        ]
      }
    },
    "/v1/public/pricing": {
      "get": {
        "description": "Returns the public GPU and services pricing catalog. No authentication required.",
        "operationId": "getV1PublicPricing",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicPricingResponse"
                }
              }
            },
            "description": "OK"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "summary": "Public pricing catalog",
        "tags": [
          "Pricing"
        ]
      }
    },
    "/v1/public/shared-capacities": {
      "get": {
        "description": "",
        "operationId": "",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedCapacityPublicListResponse"
                }
              }
            },
            "description": "OK"
          }
        },
        "summary": "List public shared capacities",
        "tags": [
          "Shared Capacity"
        ]
      }
    },
    "/v1/public/shared-capacities/{slug}": {
      "get": {
        "description": "",
        "operationId": "",
        "parameters": [
          {
            "description": "Public shared capacity slug",
            "in": "path",
            "name": "slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedCapacityPublicResponse"
                }
              }
            },
            "description": "OK"
          }
        },
        "summary": "Get a public shared capacity",
        "tags": [
          "Shared Capacity"
        ]
      }
    },
    "/v1/public/shared-capacity-links/{token}": {
      "get": {
        "description": "",
        "operationId": "",
        "parameters": [
          {
            "description": "Referral token",
            "in": "path",
            "name": "token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedCapacityPublicResponse"
                }
              }
            },
            "description": "OK"
          }
        },
        "summary": "Resolve a public shared capacity link",
        "tags": [
          "Shared Capacity"
        ]
      }
    },
    "/v1/realtime": {
      "get": {
        "description": "Proxies a turn-based or native-duplex realtime session to the instance serving the requested Omni model. The legacy duplex=1 alias selects duplex mode; clients must still send the rc1 session.update with ref_audio. Accepts Bearer access tokens or API keys. Exchanges OpenAI-Realtime-style events (session.update, input_audio_buffer.append, response.create, response.audio.delta).",
        "operationId": "getV1Realtime",
        "parameters": [
          {
            "description": "Model serving name",
            "in": "query",
            "name": "model",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Realtime mode (turn or duplex)",
            "in": "query",
            "name": "mode",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Legacy native-duplex alias (1/true/on); requires a duplex-capable model",
            "in": "query",
            "name": "duplex",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Resume a realtime session id",
            "in": "query",
            "name": "session_id",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Auto-start the realtime session (1/true/on)",
            "in": "query",
            "name": "autostart",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "101": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "WebSocket upgrade"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Realtime WebSocket proxy",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/replica-sets": {
      "get": {
        "description": "",
        "operationId": "getReplicaSets",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReplicaSetListResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List replica sets",
        "tags": [
          "Replica Sets"
        ]
      }
    },
    "/v1/replica-sets/{replicaSetID}": {
      "delete": {
        "description": "",
        "operationId": "deleteReplicaSet",
        "parameters": [
          {
            "description": "Replica set ID",
            "in": "path",
            "name": "replicaSetID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Delete a replica set",
        "tags": [
          "Replica Sets"
        ]
      },
      "get": {
        "description": "",
        "operationId": "getReplicaSet",
        "parameters": [
          {
            "description": "Replica set ID",
            "in": "path",
            "name": "replicaSetID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReplicaSetResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get a replica set",
        "tags": [
          "Replica Sets"
        ]
      },
      "patch": {
        "description": "",
        "operationId": "patchReplicaSet",
        "parameters": [
          {
            "description": "Replica set ID",
            "in": "path",
            "name": "replicaSetID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateReplicaSetRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReplicaSetResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Update a replica set",
        "tags": [
          "Replica Sets"
        ]
      }
    },
    "/v1/replica-sets/{replicaSetID}/scale": {
      "post": {
        "description": "",
        "operationId": "postReplicaSetScale",
        "parameters": [
          {
            "description": "Replica set ID",
            "in": "path",
            "name": "replicaSetID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ScaleReplicaSetRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReplicaSetResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Scale a replica set",
        "tags": [
          "Replica Sets"
        ]
      }
    },
    "/v1/responses": {
      "get": {
        "description": "WebSocket transport for the Responses API. Accepts Bearer access tokens or API keys. Upgrades the HTTP request to a WebSocket session that exchanges Responses payloads.",
        "operationId": "getV1ResponsesWebSocket",
        "responses": {
          "101": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "WebSocket upgrade"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "OpenAI-compatible Responses API over WebSocket",
        "tags": [
          "AI Inference"
        ]
      },
      "post": {
        "description": "Executes a Responses API request using a managed instance or public model. Accepts Bearer access tokens or API keys. Supports streaming (SSE) when \"stream\": true.",
        "operationId": "postV1Responses",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResponsesRequestEnvelope"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OpenAI response object or SSE stream"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "OpenAI-compatible Responses API",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/responses/compact": {
      "post": {
        "description": "Compresses a conversation history into a compact representation for context management. Accepts Bearer access tokens or API keys.",
        "operationId": "postV1ResponsesCompact",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResponsesRequestEnvelope"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "Compaction response object"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Compact a Responses conversation",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/responses/sessions": {
      "delete": {
        "description": "",
        "operationId": "deleteV1ResponsesSessions",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Delete all saved Responses conversations",
        "tags": [
          "AI Inference"
        ]
      },
      "get": {
        "description": "Lists the account's stored response snapshots (chat logs) with optional model, tag, limit and cursor filters.",
        "operationId": "getV1ResponsesSessionsList",
        "parameters": [
          {
            "description": "Filter by model",
            "in": "query",
            "name": "model",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter by metadata tag (key:value, repeatable)",
            "in": "query",
            "name": "tag",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Max rows (default 50, max 200)",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "description": "Opaque pagination cursor",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "List saved Responses conversations",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/responses/sessions/status": {
      "get": {
        "description": "",
        "operationId": "getV1ResponsesSessionsStatus",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Read the account persistence switch",
        "tags": [
          "AI Inference"
        ]
      },
      "put": {
        "description": "",
        "operationId": "putV1ResponsesSessionsStatus",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": true,
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Flip the account persistence switch",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/responses/sessions/{response_id}": {
      "delete": {
        "description": "Deletes one snapshot, or the full conversation chain when \"conversation\": true.",
        "operationId": "deleteV1ResponsesSession",
        "parameters": [
          {
            "description": "Response id",
            "in": "path",
            "name": "response_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Delete the full conversation chain",
            "in": "query",
            "name": "conversation",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Delete a saved response or whole conversation",
        "tags": [
          "AI Inference"
        ]
      },
      "get": {
        "description": "",
        "operationId": "getV1ResponsesSessionDetail",
        "parameters": [
          {
            "description": "Response id",
            "in": "path",
            "name": "response_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Get a saved Responses conversation",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/serving-endpoints": {
      "get": {
        "description": "",
        "operationId": "getServingEndpoints",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "items": {
                      "$ref": "#/components/schemas/ServingEndpointResponse"
                    },
                    "type": "array"
                  },
                  "type": "object"
                }
              }
            },
            "description": "endpoints"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List serving endpoints",
        "tags": [
          "Serving Endpoints"
        ]
      },
      "post": {
        "description": "",
        "operationId": "postServingEndpoint",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateServingEndpointRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServingEndpointResponse"
                }
              }
            },
            "description": "Created"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "type": "string"
                  },
                  "type": "object"
                }
              }
            },
            "description": "name conflict"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create a serving endpoint",
        "tags": [
          "Serving Endpoints"
        ]
      }
    },
    "/v1/shared-capacities": {
      "get": {
        "description": "",
        "operationId": "",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedCapacityListResponse"
                }
              }
            },
            "description": "OK"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List shared capacities for the current account",
        "tags": [
          "Shared Capacity"
        ]
      }
    },
    "/v1/shared-capacities/join": {
      "post": {
        "description": "",
        "operationId": "",
        "parameters": [
          {
            "description": "Join idempotency key",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/JoinSharedCapacityRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedCapacityMembershipResponse"
                }
              }
            },
            "description": "OK"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Join a shared capacity",
        "tags": [
          "Shared Capacity"
        ]
      }
    },
    "/v1/shared-capacities/{groupID}": {
      "get": {
        "description": "",
        "operationId": "",
        "parameters": [
          {
            "description": "Shared capacity group ID",
            "in": "path",
            "name": "groupID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedCapacityResponse"
                }
              }
            },
            "description": "OK"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get an account shared capacity",
        "tags": [
          "Shared Capacity"
        ]
      }
    },
    "/v1/shared-capacities/{groupID}/disable": {
      "post": {
        "description": "",
        "operationId": "",
        "parameters": [
          {
            "description": "Shared capacity group ID",
            "in": "path",
            "name": "groupID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedCapacityResponse"
                }
              }
            },
            "description": "OK"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Disable shared capacity",
        "tags": [
          "Shared Capacity"
        ]
      }
    },
    "/v1/shared-capacities/{groupID}/leave": {
      "post": {
        "description": "",
        "operationId": "",
        "parameters": [
          {
            "description": "Shared capacity group ID",
            "in": "path",
            "name": "groupID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedCapacityMembershipResponse"
                }
              }
            },
            "description": "OK"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Leave a shared capacity",
        "tags": [
          "Shared Capacity"
        ]
      }
    },
    "/v1/shared-capacities/{groupID}/links": {
      "post": {
        "description": "",
        "operationId": "",
        "parameters": [
          {
            "description": "Shared capacity group ID",
            "in": "path",
            "name": "groupID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedCapacityLinkResponse"
                }
              }
            },
            "description": "Created"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create a shared capacity referral link",
        "tags": [
          "Shared Capacity"
        ]
      }
    },
    "/v1/shared-capacities/{groupID}/links/{linkID}/revoke": {
      "post": {
        "description": "",
        "operationId": "",
        "parameters": [
          {
            "description": "Shared capacity group ID",
            "in": "path",
            "name": "groupID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Referral link ID",
            "in": "path",
            "name": "linkID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Revoke a shared capacity referral link",
        "tags": [
          "Shared Capacity"
        ]
      }
    },
    "/v1/smart-balancers": {
      "get": {
        "description": "",
        "operationId": "getSmartBalancers",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "items": {
                      "$ref": "#/components/schemas/SmartBalancerViewResponse"
                    },
                    "type": "array"
                  },
                  "type": "object"
                }
              }
            },
            "description": "smart_balancers"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List smart balancers",
        "tags": [
          "Smart Balancers"
        ]
      },
      "post": {
        "description": "",
        "operationId": "postSmartBalancer",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSmartBalancerRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SmartBalancerViewResponse"
                }
              }
            },
            "description": "Created"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create a smart balancer",
        "tags": [
          "Smart Balancers"
        ]
      }
    },
    "/v1/smart-balancers/{smartBalancerID}": {
      "delete": {
        "description": "",
        "operationId": "deleteSmartBalancer",
        "parameters": [
          {
            "description": "Smart balancer ID",
            "in": "path",
            "name": "smartBalancerID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Delete a smart balancer",
        "tags": [
          "Smart Balancers"
        ]
      },
      "patch": {
        "description": "",
        "operationId": "patchSmartBalancer",
        "parameters": [
          {
            "description": "Smart balancer ID",
            "in": "path",
            "name": "smartBalancerID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSmartBalancerRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SmartBalancerViewResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Update a smart balancer",
        "tags": [
          "Smart Balancers"
        ]
      }
    },
    "/v1/target-groups": {
      "get": {
        "description": "",
        "operationId": "getTargetGroups",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "items": {
                      "$ref": "#/components/schemas/TargetGroupResponse"
                    },
                    "type": "array"
                  },
                  "type": "object"
                }
              }
            },
            "description": "groups"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List target groups",
        "tags": [
          "Target Groups"
        ]
      },
      "post": {
        "description": "",
        "operationId": "postTargetGroup",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateTargetGroupRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TargetGroupResponse"
                }
              }
            },
            "description": "Created"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create a target group",
        "tags": [
          "Target Groups"
        ]
      }
    },
    "/v1/target-groups/{targetGroupID}": {
      "delete": {
        "description": "",
        "operationId": "deleteTargetGroup",
        "parameters": [
          {
            "description": "Target group ID",
            "in": "path",
            "name": "targetGroupID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Delete a target group",
        "tags": [
          "Target Groups"
        ]
      },
      "get": {
        "description": "",
        "operationId": "getTargetGroup",
        "parameters": [
          {
            "description": "Target group ID",
            "in": "path",
            "name": "targetGroupID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TargetGroupResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get a target group",
        "tags": [
          "Target Groups"
        ]
      },
      "patch": {
        "description": "",
        "operationId": "patchTargetGroup",
        "parameters": [
          {
            "description": "Target group ID",
            "in": "path",
            "name": "targetGroupID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTargetGroupRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TargetGroupResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Update a target group",
        "tags": [
          "Target Groups"
        ]
      }
    },
    "/v1/templates": {
      "get": {
        "description": "Lists pre-configured deployment template variants visible to the authenticated user.",
        "operationId": "getV1Templates",
        "parameters": [
          {
            "description": "Page size (default 50, max 100)",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "description": "Page offset",
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "description": "Locale (default en)",
            "in": "query",
            "name": "locale",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Category filter",
            "in": "query",
            "name": "category",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Tag filter",
            "in": "query",
            "name": "tag",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Only featured templates",
            "in": "query",
            "name": "featured_only",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListUserVariantsResponse"
                }
              }
            },
            "description": "OK"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Service Unavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List template variants",
        "tags": [
          "Templates"
        ]
      }
    },
    "/v1/templates/by-slug/{slug}": {
      "get": {
        "description": "Returns a template variant by its URL slug for the authenticated user.",
        "operationId": "getV1TemplateBySlug",
        "parameters": [
          {
            "description": "Template slug",
            "in": "path",
            "name": "slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Locale (default en)",
            "in": "query",
            "name": "locale",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetTemplateBySlugResponse"
                }
              }
            },
            "description": "OK"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Service Unavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get a template by slug",
        "tags": [
          "Templates"
        ]
      }
    },
    "/v1/templates/{id}": {
      "get": {
        "description": "Returns a single template variant by ID for the authenticated user.",
        "operationId": "getV1Template",
        "parameters": [
          {
            "description": "Template variant ID",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Locale (default en)",
            "in": "query",
            "name": "locale",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetUserVariantResponse"
                }
              }
            },
            "description": "OK"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Service Unavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get a template variant",
        "tags": [
          "Templates"
        ]
      }
    },
    "/v1/timeseries/forecasts": {
      "post": {
        "description": "Account-owned serving name or instance UUID. Horizon 1..1024, 1..32 records, 1..32 channels, context 1..15360. Input/output budgets are one million numbers; request/response limits are 16/32 MiB. Quantiles default true; inference timeout is two minutes after readiness.",
        "operationId": "postV1TimeseriesForecast",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Execution.ForecastRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Execution.ForecastResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Request Entity Too Large"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unsupported Media Type"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Service Unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Gateway Timeout"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Forecast channel-major time series",
        "tags": [
          "AI Inference"
        ]
      }
    },
    "/v1/tool-deployments": {
      "get": {
        "description": "List deployments owned by the authenticated account.",
        "operationId": "get_v1_tool_deployments",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "deployments": [
                    {
                      "current_version_id": "version_xxx",
                      "deployment_id": "dep_xxx",
                      "image_digest": "qdiv0/managed-tools@sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                      "policy_revision": "policy-2026-08-27",
                      "provider_key": "lambda:dep_xxx",
                      "repository": {
                        "owner": "example-org",
                        "protected_ref": "refs/tags/v1.0.0",
                        "repository": "example-server",
                        "workflow": ".github/workflows/release.yml"
                      },
                      "server_name": "example-server",
                      "server_version": "1.0.0",
                      "status": "published",
                      "tools": [],
                      "versions": [
                        {
                          "commit_sha": "abc123",
                          "image_digest": "qdiv0/managed-tools@sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                          "provenance_reference": "oci://...",
                          "release_version": "v1.0.0",
                          "runtime_revision": "runtime-node-v1",
                          "sbom_reference": "oci://...",
                          "status": "published",
                          "version_id": "version_xxx",
                          "workflow_run_id": "123456"
                        }
                      ]
                    }
                  ]
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List tool deployments",
        "tags": [
          "Tool Deployments"
        ]
      },
      "post": {
        "description": "Create an account-bound Lambda tool deployment from a strict YAML manifest. An empty spec.server.image is valid only for a pending registration; the immutable staging artifact is established at finalization.",
        "operationId": "post_v1_tool_deployments",
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "idempotency_key": "release-2026-08-27",
                "manifest_yaml": "apiVersion: tools.valendra.io/v1\\nkind: ToolDeployment\\n...",
                "repository": {
                  "owner": "example-org",
                  "protected_ref": "refs/tags/v1.0.0",
                  "repository": "example-server",
                  "workflow": ".github/workflows/release.yml"
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "example": {
                  "deployment_id": "dep_xxx",
                  "image_digest": "",
                  "policy_revision": "policy-2026-08-27",
                  "provider_key": "lambda:dep_xxx",
                  "repository": {
                    "owner": "example-org",
                    "protected_ref": "refs/tags/v1.0.0",
                    "repository": "example-server",
                    "workflow": ".github/workflows/release.yml"
                  },
                  "server_name": "example-server",
                  "server_version": "1.0.0",
                  "status": "pending_upload"
                }
              }
            },
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create tool deployment",
        "tags": [
          "Tool Deployments"
        ]
      }
    },
    "/v1/tool-deployments/{deploymentID}": {
      "get": {
        "description": "Get an account-bound tool deployment without exposing runtime credentials or tenant internals.",
        "operationId": "get_v1_tool_deployments_deploymentID",
        "parameters": [
          {
            "description": "Deployment ID",
            "in": "path",
            "name": "deploymentID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "current_version_id": "version_xxx",
                  "deployment_id": "dep_xxx",
                  "image_digest": "qdiv0/managed-tools@sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                  "policy_revision": "policy-2026-08-27",
                  "provider_key": "lambda:dep_xxx",
                  "repository": {
                    "owner": "example-org",
                    "protected_ref": "refs/tags/v1.0.0",
                    "repository": "example-server",
                    "workflow": ".github/workflows/release.yml"
                  },
                  "server_name": "example-server",
                  "server_version": "1.0.0",
                  "status": "published",
                  "tools": [],
                  "versions": [
                    {
                      "commit_sha": "abc123",
                      "image_digest": "qdiv0/managed-tools@sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                      "provenance_reference": "oci://...",
                      "release_version": "v1.0.0",
                      "runtime_revision": "runtime-node-v1",
                      "sbom_reference": "oci://...",
                      "status": "published",
                      "version_id": "version_xxx",
                      "workflow_run_id": "123456"
                    }
                  ]
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get tool deployment",
        "tags": [
          "Tool Deployments"
        ]
      }
    },
    "/v1/tool-deployments/{deploymentID}/finalize": {
      "post": {
        "description": "Verify, discover, provision, and publish an immutable tool deployment.",
        "operationId": "post_v1_tool_deployments_deploymentID_finalize",
        "parameters": [
          {
            "description": "Deployment ID",
            "in": "path",
            "name": "deploymentID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Short-lived GitHub Actions OIDC token. Never include this value in the request body or logs.",
            "in": "header",
            "name": "X-Valendra-GitHub-OIDC-Token",
            "required": true,
            "schema": {
              "format": "password",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "commit_sha": "abc123",
                "image_digest": "qdiv0/managed-tools-staging@sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                "provenance_reference": "oci://...",
                "release_version": "v1.0.0",
                "sbom_reference": "oci://...",
                "session_id": "session_xxx",
                "workflow_run_id": "123456"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "current_version_id": "version_xxx",
                  "deployment_id": "dep_xxx",
                  "image_digest": "qdiv0/managed-tools@sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                  "policy_revision": "policy-2026-08-27",
                  "provider_key": "lambda:dep_xxx",
                  "repository": {
                    "owner": "example-org",
                    "protected_ref": "refs/tags/v1.0.0",
                    "repository": "example-server",
                    "workflow": ".github/workflows/release.yml"
                  },
                  "server_name": "example-server",
                  "server_version": "1.0.0",
                  "status": "published",
                  "tools": [],
                  "versions": [
                    {
                      "commit_sha": "abc123",
                      "image_digest": "qdiv0/managed-tools@sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                      "provenance_reference": "oci://...",
                      "release_version": "v1.0.0",
                      "runtime_revision": "runtime-node-v1",
                      "sbom_reference": "oci://...",
                      "status": "published",
                      "version_id": "version_xxx",
                      "workflow_run_id": "123456"
                    }
                  ]
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Finalize tool deployment",
        "tags": [
          "Tool Deployments"
        ]
      }
    },
    "/v1/tool-deployments/{deploymentID}/revoke": {
      "post": {
        "description": "Revoke a deployment before it can be resolved for invocation.",
        "operationId": "post_v1_tool_deployments_deploymentID_revoke",
        "parameters": [
          {
            "description": "Deployment ID",
            "in": "path",
            "name": "deploymentID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "current_version_id": "version_xxx",
                  "deployment_id": "dep_xxx",
                  "image_digest": "qdiv0/managed-tools@sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                  "policy_revision": "policy-2026-08-27",
                  "provider_key": "lambda:dep_xxx",
                  "repository": {
                    "owner": "example-org",
                    "protected_ref": "refs/tags/v1.0.0",
                    "repository": "example-server",
                    "workflow": ".github/workflows/release.yml"
                  },
                  "server_name": "example-server",
                  "server_version": "1.0.0",
                  "status": "published",
                  "tools": [],
                  "versions": [
                    {
                      "commit_sha": "abc123",
                      "image_digest": "qdiv0/managed-tools@sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                      "provenance_reference": "oci://...",
                      "release_version": "v1.0.0",
                      "runtime_revision": "runtime-node-v1",
                      "sbom_reference": "oci://...",
                      "status": "published",
                      "version_id": "version_xxx",
                      "workflow_run_id": "123456"
                    }
                  ]
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Revoke tool deployment",
        "tags": [
          "Tool Deployments"
        ]
      }
    },
    "/v1/tool-deployments/{deploymentID}/rollback": {
      "post": {
        "description": "Move the registry pointer to a previously verified immutable version.",
        "operationId": "post_v1_tool_deployments_deploymentID_rollback",
        "parameters": [
          {
            "description": "Deployment ID",
            "in": "path",
            "name": "deploymentID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "target_version": "version_xxx"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "current_version_id": "version_xxx",
                  "deployment_id": "dep_xxx",
                  "image_digest": "qdiv0/managed-tools@sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                  "policy_revision": "policy-2026-08-27",
                  "provider_key": "lambda:dep_xxx",
                  "repository": {
                    "owner": "example-org",
                    "protected_ref": "refs/tags/v1.0.0",
                    "repository": "example-server",
                    "workflow": ".github/workflows/release.yml"
                  },
                  "server_name": "example-server",
                  "server_version": "1.0.0",
                  "status": "published",
                  "tools": [],
                  "versions": [
                    {
                      "commit_sha": "abc123",
                      "image_digest": "qdiv0/managed-tools@sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                      "provenance_reference": "oci://...",
                      "release_version": "v1.0.0",
                      "runtime_revision": "runtime-node-v1",
                      "sbom_reference": "oci://...",
                      "status": "published",
                      "version_id": "version_xxx",
                      "workflow_run_id": "123456"
                    }
                  ]
                }
              }
            },
            "description": "Success"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Rollback tool deployment",
        "tags": [
          "Tool Deployments"
        ]
      }
    },
    "/v1/tool-deployments/{deploymentID}/upload-session": {
      "post": {
        "description": "Create a short-lived artifact upload session after GitHub OIDC claim validation. The artifact digest may be omitted when it is not known until after the image push.",
        "operationId": "post_v1_tool_deployments_deploymentID_upload_session",
        "parameters": [
          {
            "description": "Deployment ID",
            "in": "path",
            "name": "deploymentID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Short-lived GitHub Actions OIDC token. Never include this value in the request body or logs.",
            "in": "header",
            "name": "X-Valendra-GitHub-OIDC-Token",
            "required": true,
            "schema": {
              "format": "password",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "artifact_digest": "staging-repository@sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "example": {
                  "expires_at": "2026-08-27T12:15:00Z",
                  "region": "eu-west-1",
                  "repository": "staging-repository",
                  "role_arn": "arn:aws:iam::...:role/qdiv0-upload",
                  "session_id": "session_xxx"
                }
              }
            },
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create upload session",
        "tags": [
          "Tool Deployments"
        ]
      }
    },
    "/v1/tools": {
      "get": {
        "description": "Lists all available platform tools for the authenticated account.",
        "operationId": "getTools",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List tools",
        "tags": [
          "System"
        ]
      }
    },
    "/v1/tools/{toolType}/try": {
      "post": {
        "description": "Runs a single platform tool with the given configuration and returns the raw tool output.",
        "operationId": "tryTool",
        "parameters": [
          {
            "description": "Tool type",
            "in": "path",
            "name": "toolType",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": true,
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Try a tool",
        "tags": [
          "System"
        ]
      }
    },
    "/v1/users/me/api-keys": {
      "get": {
        "description": "Returns the API keys issued for the authenticated user identity.",
        "operationId": "getUserAPIKeys",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKeyListResponse"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List API keys for the authenticated user",
        "tags": [
          "API Keys"
        ]
      },
      "post": {
        "description": "Issues a new API key for the authenticated user identity and returns the plaintext key once.",
        "operationId": "postUserAPIKeys",
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKeyResponse"
                }
              }
            },
            "description": "Created"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create an API key for the authenticated user",
        "tags": [
          "API Keys"
        ]
      }
    },
    "/v1/users/me/api-keys/{keyID}/revoke": {
      "post": {
        "description": "Revokes an API key issued for the authenticated user identity.",
        "operationId": "postUserAPIKeysKeyIDRevoke",
        "parameters": [
          {
            "description": "API key ID",
            "in": "path",
            "name": "keyID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Revoke a user API key",
        "tags": [
          "API Keys"
        ]
      }
    },
    "/v1/users/me/tutorial-progress": {
      "get": {
        "description": "Returns the onboarding tutorial progress for the authenticated user in the active account. New users have found=false.",
        "operationId": "getTutorialProgress",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TutorialProgressResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get incremental tutorial progress",
        "tags": [
          "tutorial"
        ]
      },
      "put": {
        "description": "Persists onboarding tutorial progress for the authenticated user in the active account. Completed step ids are merged server-side so steps are never lost.",
        "operationId": "putTutorialProgress",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTutorialProgressRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TutorialProgressResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "missing credentials or invalid access token"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Update incremental tutorial progress",
        "tags": [
          "tutorial"
        ]
      }
    },
    "/v1/videos": {
      "post": {
        "description": "Generates a video from a prompt and optional image, video, and audio references. Accepts Bearer access tokens or API keys. MiniMax-H3 Ref2VA accepts one to nine image references with optional audio, or one or more video references without audio; FL2VA accepts up to two images. MiniMax-H3 prompts are limited to 7,000 Unicode characters; image references are limited to 30 MiB, video references to 50 MiB, audio references to 15 MiB, and the aggregate input-reference plus audio bytes to 64 MiB. HTTP(S) audio_reference_url values are limited to 16 KiB; data URLs are limited by the 15 MiB decoded audio payload.",
        "operationId": "postV1VideoGenerations",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "properties": {
                  "aspect_ratio": {
                    "description": "Output aspect ratio: a standard ratio may accompany matching dimensions; adaptive requires short_edge",
                    "enum": [
                      "21:9",
                      "16:9",
                      "4:3",
                      "1:1",
                      "3:4",
                      "9:16",
                      "adaptive"
                    ],
                    "type": "string"
                  },
                  "audio_flow_shift": {
                    "default": 3,
                    "description": "Non-negative audio flow shift",
                    "minimum": 0,
                    "type": "number"
                  },
                  "audio_reference": {
                    "description": "Audio reference up to 15 MiB",
                    "format": "binary",
                    "type": "string"
                  },
                  "audio_reference_url": {
                    "description": "Hosted audio reference URL; HTTP(S) URLs are limited to 16 KiB and data URLs to the bounded decoded-audio ceiling",
                    "format": "uri",
                    "maxLength": 20972544,
                    "type": "string"
                  },
                  "duration": {
                    "default": 5,
                    "description": "Duration in seconds",
                    "maximum": 15,
                    "minimum": 4,
                    "type": "number"
                  },
                  "flow_shift": {
                    "default": 12,
                    "description": "Non-negative flow shift",
                    "minimum": 0,
                    "type": "number"
                  },
                  "fps": {
                    "default": 24,
                    "description": "Frames per second; only 24 is supported",
                    "enum": [
                      24
                    ],
                    "type": "integer"
                  },
                  "height": {
                    "description": "Output height; provide with width; may accompany a matching standard aspect_ratio",
                    "maximum": 5760,
                    "minimum": 256,
                    "type": "integer"
                  },
                  "input_reference": {
                    "description": "Image reference up to 30 MiB or video reference up to 50 MiB; may be repeated. H3 Ref2VA accepts one to nine images; FL2VA accepts up to two images; aggregate references plus optional audio are limited to 64 MiB",
                    "format": "binary",
                    "type": "string"
                  },
                  "input_references": {
                    "description": "Image reference up to 30 MiB or video reference up to 50 MiB; may be repeated. H3 Ref2VA accepts one to nine images; FL2VA accepts up to two images; aggregate references plus optional audio are limited to 64 MiB",
                    "format": "binary",
                    "type": "string"
                  },
                  "model": {
                    "description": "Model ID",
                    "type": "string"
                  },
                  "num_inference_steps": {
                    "default": 50,
                    "description": "Inference steps",
                    "maximum": 200,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "prompt": {
                    "description": "Video prompt (maximum 7,000 Unicode characters)",
                    "maxLength": 7000,
                    "type": "string"
                  },
                  "seed": {
                    "description": "Random seed",
                    "format": "int64",
                    "minimum": 0,
                    "type": "integer"
                  },
                  "short_edge": {
                    "description": "Output short edge; only valid with aspect_ratio=adaptive",
                    "maximum": 5760,
                    "minimum": 256,
                    "type": "integer"
                  },
                  "task": {
                    "default": "t2va",
                    "description": "Generation task: t2va, fl2va, ref2va, t2v, or i2v",
                    "enum": [
                      "t2va",
                      "fl2va",
                      "ref2va",
                      "t2v",
                      "i2v"
                    ],
                    "type": "string"
                  },
                  "width": {
                    "description": "Output width; provide with height; may accompany a matching standard aspect_ratio",
                    "maximum": 5760,
                    "minimum": 256,
                    "type": "integer"
                  }
                },
                "required": [
                  "model",
                  "prompt"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "video/mp4": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "Generated MP4 video bytes"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "402": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Payment Required"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Request Entity Too Large"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Too Many Requests"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Gateway"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Service Unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Gateway Timeout"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Synchronous video generation",
        "tags": [
          "AI Inference"
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://api.qdiv0.com"
    }
  ],
  "tags": [
    {
      "name": "Auth"
    },
    {
      "name": "Accounts"
    },
    {
      "name": "API Keys"
    },
    {
      "name": "Invitations"
    },
    {
      "name": "Billing"
    },
    {
      "name": "Notifications"
    },
    {
      "name": "Audit"
    },
    {
      "name": "Instances"
    },
    {
      "name": "Serving Endpoints"
    },
    {
      "name": "Smart Balancers"
    },
    {
      "name": "Target Groups"
    },
    {
      "name": "Replica Sets"
    },
    {
      "name": "Firewalls"
    },
    {
      "name": "Firewall Rules"
    },
    {
      "name": "Vector Databases"
    },
    {
      "name": "AI Inference"
    },
    {
      "name": "Models"
    },
    {
      "name": "Pricing"
    },
    {
      "name": "System"
    },
    {
      "name": "Templates"
    },
    {
      "name": "Tool Deployments"
    },
    {
      "name": "Agent"
    },
    {
      "name": "Connectors"
    },
    {
      "name": "Automations"
    },
    {
      "name": "Shared Capacity"
    },
    {
      "name": "tutorial"
    }
  ]
}