{
  "openapi": "3.1.0",
  "info": {
    "title": "Virtneu Auth Server API",
    "version": "0.7.0",
    "description": "Implemented Global backend-only preview API. Management APIs are excluded. User reads require users:read, account access checks require the separate users:status permission. User metadata uses profile_metadata and managed_metadata. User deletion is permanent and requires the separate users:delete scope, an exact external identity confirmation and a stable idempotency key. Validation never refreshes sessions; explicit refresh retains the token and its creation-time lifetime policy. Default lifetime is 7 days, absolute limit 30 days; each App/environment can configure new sessions."
  },
  "servers": [
    {
      "url": "https://auth-api.virtneu.com"
    }
  ],
  "paths": {
    "/v1/integration/readiness": {
      "get": {
        "operationId": "getIntegrationReadiness",
        "description": "Read actual selected App/environment authentication schema, policy and decryptable tested/enabled mail configuration checks. Requires sessions:validate and auth:challenge. HTTP 503 with the same data envelope means a check failed; authorization failures use the normal error envelope. Checks never send email. Ready is configuration readiness, not evidence of inbox delivery, sustained probes, external alerts, deployed capacity or provider restore. Those external acceptance gates are explicitly not_evaluated. No secrets, SQL or tenant identity fields are returned.",
        "x-required-scope": "sessions:validate + auth:challenge",
        "x-required-scopes": [
          "sessions:validate",
          "auth:challenge"
        ],
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "readiness_version": {
                          "const": 1
                        },
                        "platform_env_id": {
                          "type": "string"
                        },
                        "scope": {
                          "enum": [
                            "runtime",
                            "tenant_configuration"
                          ]
                        },
                        "ready": {
                          "type": "boolean"
                        },
                        "checked_at": {
                          "type": "integer"
                        },
                        "checks": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": false,
                            "properties": {
                              "name": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 1024
                              },
                              "status": {
                                "enum": [
                                  "passed",
                                  "failed"
                                ]
                              },
                              "code": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 1024
                              }
                            },
                            "required": [
                              "name",
                              "status"
                            ]
                          }
                        },
                        "external_acceptance": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "inbox_delivery": {
                              "const": "not_evaluated"
                            },
                            "sustained_probe": {
                              "const": "not_evaluated"
                            },
                            "external_alert_delivery": {
                              "const": "not_evaluated"
                            },
                            "deployed_capacity": {
                              "const": "not_evaluated"
                            },
                            "provider_restore": {
                              "const": "not_evaluated"
                            }
                          },
                          "required": [
                            "inbox_delivery",
                            "sustained_probe",
                            "external_alert_delivery",
                            "deployed_capacity",
                            "provider_restore"
                          ]
                        }
                      },
                      "required": [
                        "readiness_version",
                        "scope",
                        "ready",
                        "checked_at",
                        "checks",
                        "external_acceptance"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Readiness failed (data envelope), or an authorization dependency failed (error envelope).",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "data": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "readiness_version": {
                              "const": 1
                            },
                            "platform_env_id": {
                              "type": "string"
                            },
                            "scope": {
                              "enum": [
                                "runtime",
                                "tenant_configuration"
                              ]
                            },
                            "ready": {
                              "type": "boolean"
                            },
                            "checked_at": {
                              "type": "integer"
                            },
                            "checks": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "additionalProperties": false,
                                "properties": {
                                  "name": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 1024
                                  },
                                  "status": {
                                    "enum": [
                                      "passed",
                                      "failed"
                                    ]
                                  },
                                  "code": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 1024
                                  }
                                },
                                "required": [
                                  "name",
                                  "status"
                                ]
                              }
                            },
                            "external_acceptance": {
                              "type": "object",
                              "additionalProperties": false,
                              "properties": {
                                "inbox_delivery": {
                                  "const": "not_evaluated"
                                },
                                "sustained_probe": {
                                  "const": "not_evaluated"
                                },
                                "external_alert_delivery": {
                                  "const": "not_evaluated"
                                },
                                "deployed_capacity": {
                                  "const": "not_evaluated"
                                },
                                "provider_restore": {
                                  "const": "not_evaluated"
                                }
                              },
                              "required": [
                                "inbox_delivery",
                                "sustained_probe",
                                "external_alert_delivery",
                                "deployed_capacity",
                                "provider_restore"
                              ]
                            }
                          },
                          "required": [
                            "readiness_version",
                            "scope",
                            "ready",
                            "checked_at",
                            "checks",
                            "external_acceptance"
                          ]
                        },
                        "request_id": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "data",
                        "request_id"
                      ]
                    },
                    {
                      "$ref": "#/components/schemas/Error"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/integration/mail-readiness": {
      "get": {
        "operationId": "getMailReadiness",
        "description": "Read redacted mail configuration readiness for the current App/environment. Does not send email or establish delivery, provider connectivity, or a completed login. Includes the Studio settings URL and blocking configuration states. Requires auth:challenge.",
        "x-required-scope": "auth:challenge",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "application_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "environment": {
                          "enum": [
                            "test",
                            "production"
                          ]
                        },
                        "configured": {
                          "type": "boolean"
                        },
                        "tested": {
                          "type": "boolean"
                        },
                        "enabled": {
                          "type": "boolean"
                        },
                        "service_configured": {
                          "type": "boolean"
                        },
                        "ready": {
                          "type": "boolean"
                        },
                        "blockers": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "revision": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "verified_at": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "last_test_at": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "last_error_code": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "settings_url": {
                          "type": "string",
                          "format": "uri"
                        },
                        "note": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "application_id",
                        "environment",
                        "configured",
                        "tested",
                        "enabled",
                        "service_configured",
                        "ready",
                        "blockers",
                        "revision",
                        "verified_at",
                        "last_test_at",
                        "last_error_code",
                        "settings_url",
                        "note"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/users/lookup": {
      "post": {
        "operationId": "lookupUser",
        "description": "Resolve exactly one identity selector: email or external_user_id. Email is trimmed and lowercased before an exact match; external_user_id matches exactly. A missing user returns 404 RESOURCE_NOT_FOUND. Disabled users remain visible. This read does not authenticate the user.",
        "x-required-scope": "users:read",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "email": {
                        "type": "string",
                        "format": "email",
                        "maxLength": 254
                      }
                    },
                    "required": [
                      "email"
                    ]
                  },
                  {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "external_user_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024
                      }
                    },
                    "required": [
                      "external_user_id"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "external_user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "email": {
                          "type": "string",
                          "format": "email",
                          "maxLength": 254
                        },
                        "email_verified": {
                          "type": "boolean"
                        },
                        "disabled": {
                          "type": "boolean"
                        },
                        "name": {
                          "type": "string"
                        },
                        "image": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "created_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "updated_at": {
                          "type": "string",
                          "format": "date-time"
                        }
                      },
                      "required": [
                        "user_id",
                        "external_user_id",
                        "email",
                        "email_verified",
                        "disabled",
                        "name",
                        "image",
                        "created_at",
                        "updated_at"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/users/{userId}": {
      "get": {
        "operationId": "getUser",
        "description": "Read one user by its Virtneu Auth user_id. A missing user returns 404 RESOURCE_NOT_FOUND. Disabled users remain visible. Only the listed profile fields are returned; metadata, session tokens and password data are excluded.",
        "x-required-scope": "users:read",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          },
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "external_user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "email": {
                          "type": "string",
                          "format": "email",
                          "maxLength": 254
                        },
                        "email_verified": {
                          "type": "boolean"
                        },
                        "disabled": {
                          "type": "boolean"
                        },
                        "name": {
                          "type": "string"
                        },
                        "image": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "created_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "updated_at": {
                          "type": "string",
                          "format": "date-time"
                        }
                      },
                      "required": [
                        "user_id",
                        "external_user_id",
                        "email",
                        "email_verified",
                        "disabled",
                        "name",
                        "image",
                        "created_at",
                        "updated_at"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteUser",
        "x-required-scope": "users:delete",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{8,128}$"
            },
            "description": "Persist with the operation and reuse with the same payload after timeout."
          },
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "external_user_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  }
                },
                "required": [
                  "external_user_id"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "deleted": {
                          "const": true
                        },
                        "user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "deleted_at": {
                          "type": "string",
                          "format": "date-time"
                        }
                      },
                      "required": [
                        "deleted",
                        "user_id",
                        "deleted_at"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "setUserDisabled",
        "x-required-scope": "users:write",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          },
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "disabled": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "disabled"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "disabled": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "disabled"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/users/batch": {
      "post": {
        "operationId": "getUsers",
        "description": "Read 1–100 distinct user_ids. users preserves the relative input order of found users; missing_user_ids preserves the relative input order of missing users. Missing users do not fail the whole batch. Disabled users remain visible. Duplicate IDs and additional body fields are rejected.",
        "x-required-scope": "users:read",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "user_ids": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 100,
                    "uniqueItems": true,
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1024
                    }
                  }
                },
                "required": [
                  "user_ids"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "users": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": false,
                            "properties": {
                              "user_id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 1024
                              },
                              "external_user_id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 1024
                              },
                              "email": {
                                "type": "string",
                                "format": "email",
                                "maxLength": 254
                              },
                              "email_verified": {
                                "type": "boolean"
                              },
                              "disabled": {
                                "type": "boolean"
                              },
                              "name": {
                                "type": "string"
                              },
                              "image": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "created_at": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "updated_at": {
                                "type": "string",
                                "format": "date-time"
                              }
                            },
                            "required": [
                              "user_id",
                              "external_user_id",
                              "email",
                              "email_verified",
                              "disabled",
                              "name",
                              "image",
                              "created_at",
                              "updated_at"
                            ]
                          }
                        },
                        "missing_user_ids": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1024
                          }
                        }
                      },
                      "required": [
                        "users",
                        "missing_user_ids"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/users": {
      "get": {
        "operationId": "listUsers",
        "description": "List users using exact email/external_user_id and optional disabled/email_verified filters. Email is trimmed and lowercased. Sorting uses created_at plus user_id as a stable tie-breaker, both in the selected direction. include_total returns the count of all matching users, excluding the cursor position, in the same database batch as the page. Pages are live reads, not a snapshot across requests. The signed cursor is bound to App, environment, service credential principal, lifecycle generation, normalized filters and sort; tampering or changing this context returns 400 INVALID_USER_CURSOR. page_size and include_total may change between pages. Unknown or repeated query parameters are rejected.",
        "x-required-scope": "users:read",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          },
          {
            "name": "email",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "email",
              "maxLength": 254
            }
          },
          {
            "name": "external_user_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024
            }
          },
          {
            "name": "disabled",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "email_verified",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "schema": {
              "enum": [
                "created_at:asc",
                "created_at:desc"
              ],
              "default": "created_at:desc"
            }
          },
          {
            "name": "include_total",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "users": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": false,
                            "properties": {
                              "user_id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 1024
                              },
                              "external_user_id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 1024
                              },
                              "email": {
                                "type": "string",
                                "format": "email",
                                "maxLength": 254
                              },
                              "email_verified": {
                                "type": "boolean"
                              },
                              "disabled": {
                                "type": "boolean"
                              },
                              "name": {
                                "type": "string"
                              },
                              "image": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "created_at": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "updated_at": {
                                "type": "string",
                                "format": "date-time"
                              }
                            },
                            "required": [
                              "user_id",
                              "external_user_id",
                              "email",
                              "email_verified",
                              "disabled",
                              "name",
                              "image",
                              "created_at",
                              "updated_at"
                            ]
                          }
                        },
                        "next_cursor": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "total": {
                          "type": "integer",
                          "minimum": 0
                        }
                      },
                      "required": [
                        "users",
                        "next_cursor"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "registerUser",
        "x-required-scope": "auth:register",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{8,128}$"
            },
            "description": "Persist with the operation and reuse with the same payload after timeout."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "external_user_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "email": {
                    "type": "string",
                    "format": "email",
                    "maxLength": 254
                  },
                  "authentication_proof": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "password": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 128
                  }
                },
                "required": [
                  "external_user_id",
                  "email",
                  "authentication_proof"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "external_user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "email_verified": {
                          "const": true
                        }
                      },
                      "required": [
                        "user_id",
                        "external_user_id",
                        "email_verified"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/users/{userId}/access/check": {
      "post": {
        "operationId": "checkUserAccess",
        "description": "Check current account safety state; this is not proof of login or ownership. Send {} to obtain the current security_version of an active user before binding a separately authenticated business credential. Send expected_security_version to require an exact match when using that credential. Missing or disabled users and version mismatches return active=false. Password reset, user disable/enable and global session revocation invalidate earlier versions. An infrastructure failure returns 503: deny the current request without treating the business credential as permanently revoked. Environment authorization and lifecycle failures remain structured errors.",
        "x-required-scope": "users:status",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          },
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "expected_security_version": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": []
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "oneOf": [
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "active": {
                              "const": false
                            }
                          },
                          "required": [
                            "active"
                          ]
                        },
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "active": {
                              "const": true
                            },
                            "security_version": {
                              "type": "integer",
                              "minimum": 0
                            }
                          },
                          "required": [
                            "active",
                            "security_version"
                          ]
                        }
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/application/metadata": {
      "get": {
        "operationId": "getApplicationMetadata",
        "x-required-scope": "metadata:read",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "revision": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Use the current revision when replacing metadata. Zero indicates that no metadata has been written."
                        },
                        "metadata": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "JSON object of at most 6144 UTF-8 bytes after compact serialization. Replacement stores the complete object; include existing keys to preserve them, or send {} to clear the object. Shared settings for one app environment, stored in application_metadata.metadata."
                        }
                      },
                      "required": [
                        "revision",
                        "metadata"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "put": {
        "operationId": "replaceApplicationMetadata",
        "x-required-scope": "metadata:write",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "revision": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Use the current revision when replacing metadata. Zero indicates that no metadata has been written."
                  },
                  "metadata": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "JSON object of at most 6144 UTF-8 bytes after compact serialization. Replacement stores the complete object; include existing keys to preserve them, or send {} to clear the object. Shared settings for one app environment, stored in application_metadata.metadata."
                  }
                },
                "required": [
                  "revision",
                  "metadata"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "revision": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Use the current revision when replacing metadata. Zero indicates that no metadata has been written."
                        },
                        "metadata": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "JSON object of at most 6144 UTF-8 bytes after compact serialization. Replacement stores the complete object; include existing keys to preserve them, or send {} to clear the object. Shared settings for one app environment, stored in application_metadata.metadata."
                        }
                      },
                      "required": [
                        "revision",
                        "metadata"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/users/{userId}/metadata": {
      "get": {
        "operationId": "getUserMetadata",
        "x-required-scope": "metadata:read",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          },
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "revision": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Use the current revision when replacing metadata. Zero indicates that no metadata has been written."
                        },
                        "profile_metadata": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "JSON object of at most 6144 UTF-8 bytes after compact serialization. Replacement stores the complete object; include existing keys to preserve them, or send {} to clear the object. User profile and preferences, stored in user_metadata.profile_metadata."
                        },
                        "managed_metadata": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "JSON object of at most 6144 UTF-8 bytes after compact serialization. Replacement stores the complete object; include existing keys to preserve them, or send {} to clear the object. User attributes managed by the application, stored in user_metadata.managed_metadata."
                        }
                      },
                      "required": [
                        "revision",
                        "profile_metadata",
                        "managed_metadata"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "put": {
        "operationId": "replaceUserMetadata",
        "x-required-scope": "metadata:write",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          },
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "revision": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Use the current revision when replacing metadata. Zero indicates that no metadata has been written."
                  },
                  "profile_metadata": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "JSON object of at most 6144 UTF-8 bytes after compact serialization. Replacement stores the complete object; include existing keys to preserve them, or send {} to clear the object. User profile and preferences, stored in user_metadata.profile_metadata."
                  },
                  "managed_metadata": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "JSON object of at most 6144 UTF-8 bytes after compact serialization. Replacement stores the complete object; include existing keys to preserve them, or send {} to clear the object. User attributes managed by the application, stored in user_metadata.managed_metadata."
                  }
                },
                "required": [
                  "revision",
                  "profile_metadata",
                  "managed_metadata"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "revision": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Use the current revision when replacing metadata. Zero indicates that no metadata has been written."
                        },
                        "profile_metadata": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "JSON object of at most 6144 UTF-8 bytes after compact serialization. Replacement stores the complete object; include existing keys to preserve them, or send {} to clear the object. User profile and preferences, stored in user_metadata.profile_metadata."
                        },
                        "managed_metadata": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "JSON object of at most 6144 UTF-8 bytes after compact serialization. Replacement stores the complete object; include existing keys to preserve them, or send {} to clear the object. User attributes managed by the application, stored in user_metadata.managed_metadata."
                        }
                      },
                      "required": [
                        "revision",
                        "profile_metadata",
                        "managed_metadata"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/events/query": {
      "post": {
        "operationId": "listAuthenticationEvents",
        "x-required-scope": "auth-events:read",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "from": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "to": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "action": {
                    "enum": [
                      "challenge_issue",
                      "challenge_verify",
                      "user_register",
                      "password_reset",
                      "session_create",
                      "session_refresh",
                      "session_revoke",
                      "user_access_change",
                      "user_sessions_revoke",
                      "user_delete",
                      "mfa_enrollment",
                      "mfa_verify",
                      "mfa_disable",
                      "mfa_recovery_codes",
                      "passkey_register",
                      "passkey_login",
                      "passkey_delete",
                      "passkey_rename",
                      "social_login",
                      "social_link",
                      "social_unlink"
                    ]
                  },
                  "outcome": {
                    "enum": [
                      "unconfirmed",
                      "succeeded",
                      "rejected"
                    ]
                  },
                  "request_id": {
                    "type": "string",
                    "maxLength": 128
                  },
                  "service_credential_id": {
                    "type": "string",
                    "maxLength": 128
                  },
                  "page_size": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                  },
                  "cursor": {
                    "type": "string",
                    "maxLength": 4096
                  }
                },
                "required": []
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "events": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": false,
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "request_id": {
                                "type": "string"
                              },
                              "action": {
                                "enum": [
                                  "challenge_issue",
                                  "challenge_verify",
                                  "user_register",
                                  "password_reset",
                                  "session_create",
                                  "session_refresh",
                                  "session_revoke",
                                  "user_access_change",
                                  "user_sessions_revoke",
                                  "user_delete",
                                  "mfa_enrollment",
                                  "mfa_verify",
                                  "mfa_disable",
                                  "mfa_recovery_codes",
                                  "passkey_register",
                                  "passkey_login",
                                  "passkey_delete",
                                  "passkey_rename",
                                  "social_login",
                                  "social_link",
                                  "social_unlink"
                                ]
                              },
                              "service_credential_id": {
                                "type": "string"
                              },
                              "outcome": {
                                "enum": [
                                  "unconfirmed",
                                  "succeeded",
                                  "rejected"
                                ]
                              },
                              "http_status": {
                                "type": [
                                  "integer",
                                  "null"
                                ]
                              },
                              "error_code": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "started_at": {
                                "type": "integer"
                              },
                              "finished_at": {
                                "type": [
                                  "integer",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "request_id",
                              "action",
                              "service_credential_id",
                              "outcome",
                              "http_status",
                              "error_code",
                              "started_at",
                              "finished_at"
                            ]
                          }
                        },
                        "next_cursor": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "range": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "from": {
                              "type": "integer"
                            },
                            "to": {
                              "type": "integer"
                            }
                          },
                          "required": [
                            "from",
                            "to"
                          ]
                        }
                      },
                      "required": [
                        "events",
                        "next_cursor",
                        "range"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/challenges": {
      "post": {
        "operationId": "createChallenge",
        "x-required-scope": "auth:challenge",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{8,128}$"
            },
            "description": "Persist with the operation and reuse with the same payload after timeout."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "external_user_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "email": {
                    "type": "string",
                    "format": "email",
                    "maxLength": 254
                  },
                  "purpose": {
                    "enum": [
                      "register",
                      "login",
                      "reset_password"
                    ]
                  }
                },
                "required": [
                  "external_user_id",
                  "email",
                  "purpose"
                ]
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "accepted": {
                          "const": true
                        },
                        "challenge_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        }
                      },
                      "required": [
                        "accepted",
                        "challenge_id"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/challenges/verify": {
      "post": {
        "operationId": "verifyChallenge",
        "x-required-scope": "auth:challenge",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{8,128}$"
            },
            "description": "Persist with the operation and reuse with the same payload after timeout."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "challenge_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "code": {
                    "type": "string",
                    "pattern": "^\\d{6}$"
                  }
                },
                "required": [
                  "challenge_id",
                  "code"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "authentication_proof": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "purpose": {
                          "enum": [
                            "register",
                            "login",
                            "reset_password"
                          ]
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        }
                      },
                      "required": [
                        "authentication_proof",
                        "purpose",
                        "expires_at"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/registrations": {
      "post": {
        "operationId": "registerUserAndSession",
        "description": "Requires both auth:register and auth:login. Consumes a register-purpose proof to create a new verified user and begin authentication. Returns 201 with a session only when the current assurance policy is satisfied; 202 returns an authentication continuation with no session_token. Persist the continuation in the protected sign-in attempt and complete enrollment/MFA before assigning identity. A login or password-reset proof is rejected, and existing users are never signed in by this endpoint. Reuse the same idempotency key and payload after timeout. The separate registerUser operation remains registration-only.",
        "x-required-scope": "auth:register + auth:login",
        "x-required-scopes": [
          "auth:register",
          "auth:login"
        ],
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{8,128}$"
            },
            "description": "Persist with the operation and reuse with the same payload after timeout."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "external_user_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "email": {
                    "type": "string",
                    "format": "email",
                    "maxLength": 254
                  },
                  "authentication_proof": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "password": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 128
                  }
                },
                "required": [
                  "external_user_id",
                  "email",
                  "authentication_proof"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Replay returns the previously completed live session.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "session_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "external_user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "absolute_expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "session_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        }
                      },
                      "required": [
                        "session_id",
                        "user_id",
                        "external_user_id",
                        "expires_at",
                        "absolute_expires_at",
                        "session_token"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "201": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "session_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "external_user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "absolute_expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "session_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        }
                      },
                      "required": [
                        "session_id",
                        "user_id",
                        "external_user_id",
                        "expires_at",
                        "absolute_expires_at",
                        "session_token"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "202": {
            "description": "Authentication is incomplete. Keep the continuation in the protected sign-in attempt. No session_token is returned and no business access may be granted.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "authentication_required": {
                          "const": true
                        },
                        "authentication_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "next_step": {
                          "enum": [
                            "mfa",
                            "enroll"
                          ]
                        },
                        "methods": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "totp",
                              "recovery_code",
                              "passkey"
                            ]
                          },
                          "description": "Use only methods explicitly offered. With next_step=enroll, passkey permits first-time discoverable enrollment only when no passkey or verified TOTP exists and policy accepts verified user verification as MFA. With next_step=mfa and methods=[passkey], restart authentication with an existing passkey; this primary continuation cannot add a new factor."
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        }
                      },
                      "required": [
                        "authentication_required",
                        "authentication_token",
                        "next_step",
                        "methods",
                        "expires_at"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/sessions": {
      "post": {
        "operationId": "createSession",
        "description": "Password sign-in has a per-identity, per-App/environment budget: 10 failed or in-flight attempts per 10-minute window. Successful sign-in releases its own reservation. An additional tenant/category HTTP-attempt budget limits distributed identity spraying; idempotent HTTP replays count toward that outer budget without changing operation receipts. Validation and refresh have independent higher budgets; revoke/delete controls remain available. RATE_LIMITED includes Retry-After. Successful primary authentication can return HTTP 202 with authentication_required=true and no session_token. Complete the specified enrollment/MFA step before granting identity or issuing a login cookie.",
        "x-required-scope": "auth:login",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{8,128}$"
            },
            "description": "Persist with the operation and reuse with the same payload after timeout."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "external_user_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024
                      },
                      "password": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024
                      }
                    },
                    "required": [
                      "external_user_id",
                      "password"
                    ]
                  },
                  {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "external_user_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024
                      },
                      "authentication_proof": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024
                      }
                    },
                    "required": [
                      "external_user_id",
                      "authentication_proof"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Replay returns the previously completed live session.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "session_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "external_user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "absolute_expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "session_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        }
                      },
                      "required": [
                        "session_id",
                        "user_id",
                        "external_user_id",
                        "expires_at",
                        "absolute_expires_at",
                        "session_token"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "201": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "session_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "external_user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "absolute_expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "session_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        }
                      },
                      "required": [
                        "session_id",
                        "user_id",
                        "external_user_id",
                        "expires_at",
                        "absolute_expires_at",
                        "session_token"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "202": {
            "description": "Authentication is incomplete. Keep the continuation in the protected sign-in attempt. No session_token is returned and no business access may be granted.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "authentication_required": {
                          "const": true
                        },
                        "authentication_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "next_step": {
                          "enum": [
                            "mfa",
                            "enroll"
                          ]
                        },
                        "methods": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "totp",
                              "recovery_code",
                              "passkey"
                            ]
                          },
                          "description": "Use only methods explicitly offered. With next_step=enroll, passkey permits first-time discoverable enrollment only when no passkey or verified TOTP exists and policy accepts verified user verification as MFA. With next_step=mfa and methods=[passkey], restart authentication with an existing passkey; this primary continuation cannot add a new factor."
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        }
                      },
                      "required": [
                        "authentication_required",
                        "authentication_token",
                        "next_step",
                        "methods",
                        "expires_at"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/mfa/status": {
      "post": {
        "operationId": "getMfaStatus",
        "description": "Requires the actual user session and sessions:validate. Returns enrollment status and remaining recovery-code count only; never returns a TOTP secret or existing recovery codes.",
        "x-required-scope": "sessions:validate",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "session_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  }
                },
                "required": [
                  "session_token"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "enabled": {
                          "type": "boolean"
                        },
                        "recovery_codes_remaining": {
                          "type": "integer",
                          "minimum": 0
                        }
                      },
                      "required": [
                        "enabled",
                        "recovery_codes_remaining"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/mfa/enroll": {
      "post": {
        "operationId": "prepareMfaEnrollment",
        "description": "Accept exactly one of authentication_token or a recent session_token. New MFA enrollment must be enabled by the App/environment policy and explicitly offered by the continuation. A password-only primary continuation cannot enroll TOTP when the account already has a passkey; authenticate with the existing factor first. To replace a lost authenticator after recovery-code sign-in, send session_token plus replace_existing=true; this requires a recent session that completed MFA or policy-accepted verified passkey UV. A primary authentication_token cannot authorize replacement. The old verified factor and its recovery codes remain effective until a new TOTP is confirmed and replaced atomically. Returns a short-lived enrollment token, TOTP URI and one-time-displayed recovery codes. Keep them out of logs and third-party QR services.",
        "x-required-scope": "auth:login",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "authentication_token": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024
                      },
                      "replace_existing": {
                        "const": false
                      }
                    },
                    "required": [
                      "authentication_token"
                    ]
                  },
                  {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "session_token": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024
                      },
                      "replace_existing": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "session_token"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "enrollment_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "totp_uri": {
                          "type": "string",
                          "format": "uri"
                        },
                        "recovery_codes": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1024
                          }
                        }
                      },
                      "required": [
                        "enrollment_token",
                        "totp_uri",
                        "recovery_codes"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/mfa/confirm": {
      "post": {
        "operationId": "confirmMfaEnrollment",
        "description": "Confirm the enrollment with a valid six-digit TOTP. A successful factor change invalidates older user security versions. Returns a new session only when assurance is complete; otherwise returns 202 continuation. Do not reuse the old session after enrollment.",
        "x-required-scope": "auth:login",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "enrollment_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "code": {
                    "type": "string",
                    "pattern": "^\\d{6}$"
                  }
                },
                "required": [
                  "enrollment_token",
                  "code"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Replay returns the previously completed live session.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "session_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "external_user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "absolute_expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "session_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        }
                      },
                      "required": [
                        "session_id",
                        "user_id",
                        "external_user_id",
                        "expires_at",
                        "absolute_expires_at",
                        "session_token"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "201": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "session_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "external_user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "absolute_expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "session_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        }
                      },
                      "required": [
                        "session_id",
                        "user_id",
                        "external_user_id",
                        "expires_at",
                        "absolute_expires_at",
                        "session_token"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "202": {
            "description": "Authentication is incomplete. Keep the continuation in the protected sign-in attempt. No session_token is returned and no business access may be granted.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "authentication_required": {
                          "const": true
                        },
                        "authentication_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "next_step": {
                          "enum": [
                            "mfa",
                            "enroll"
                          ]
                        },
                        "methods": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "totp",
                              "recovery_code",
                              "passkey"
                            ]
                          },
                          "description": "Use only methods explicitly offered. With next_step=enroll, passkey permits first-time discoverable enrollment only when no passkey or verified TOTP exists and policy accepts verified user verification as MFA. With next_step=mfa and methods=[passkey], restart authentication with an existing passkey; this primary continuation cannot add a new factor."
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        }
                      },
                      "required": [
                        "authentication_required",
                        "authentication_token",
                        "next_step",
                        "methods",
                        "expires_at"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/mfa/verify": {
      "post": {
        "operationId": "verifyMfa",
        "description": "Complete a pending primary authentication using totp or a single-use recovery_code. A 202 response remains unauthenticated; only a returned session establishes identity. The continuation is bound to the service credential principal, App/environment, user security version and lifecycle generation.",
        "x-required-scope": "auth:login",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "authentication_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "code": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "method": {
                    "enum": [
                      "totp",
                      "recovery_code"
                    ]
                  }
                },
                "required": [
                  "authentication_token",
                  "code",
                  "method"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Replay returns the previously completed live session.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "session_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "external_user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "absolute_expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "session_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        }
                      },
                      "required": [
                        "session_id",
                        "user_id",
                        "external_user_id",
                        "expires_at",
                        "absolute_expires_at",
                        "session_token"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "201": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "session_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "external_user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "absolute_expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "session_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        }
                      },
                      "required": [
                        "session_id",
                        "user_id",
                        "external_user_id",
                        "expires_at",
                        "absolute_expires_at",
                        "session_token"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "202": {
            "description": "Authentication is incomplete. Keep the continuation in the protected sign-in attempt. No session_token is returned and no business access may be granted.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "authentication_required": {
                          "const": true
                        },
                        "authentication_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "next_step": {
                          "enum": [
                            "mfa",
                            "enroll"
                          ]
                        },
                        "methods": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "totp",
                              "recovery_code",
                              "passkey"
                            ]
                          },
                          "description": "Use only methods explicitly offered. With next_step=enroll, passkey permits first-time discoverable enrollment only when no passkey or verified TOTP exists and policy accepts verified user verification as MFA. With next_step=mfa and methods=[passkey], restart authentication with an existing passkey; this primary continuation cannot add a new factor."
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        }
                      },
                      "required": [
                        "authentication_required",
                        "authentication_token",
                        "next_step",
                        "methods",
                        "expires_at"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/mfa/disable": {
      "post": {
        "operationId": "disableMfa",
        "description": "Requires auth:login plus sessions:validate, the real recent user session and TOTP. Current required-MFA policy can prevent removal. Successful mutation returns reauthentication_required=true and invalidates old sessions; no fallback session is issued.",
        "x-required-scope": "auth:login + sessions:validate",
        "x-required-scopes": [
          "auth:login",
          "sessions:validate"
        ],
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "session_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "code": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  }
                },
                "required": [
                  "session_token",
                  "code"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "disabled": {
                          "const": true
                        },
                        "reauthentication_required": {
                          "const": true
                        }
                      },
                      "required": [
                        "disabled",
                        "reauthentication_required"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/mfa/recovery-codes": {
      "post": {
        "operationId": "regenerateMfaRecoveryCodes",
        "description": "Requires auth:login plus sessions:validate, a recent user session and TOTP. Replaces recovery codes and returns the new codes once. Successful mutation requires fresh sign-in. Do not log or automatically replay after a lost response.",
        "x-required-scope": "auth:login + sessions:validate",
        "x-required-scopes": [
          "auth:login",
          "sessions:validate"
        ],
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "session_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "code": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  }
                },
                "required": [
                  "session_token",
                  "code"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "recovery_codes": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1024
                          }
                        },
                        "reauthentication_required": {
                          "const": true
                        }
                      },
                      "required": [
                        "recovery_codes",
                        "reauthentication_required"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/passkeys/list": {
      "post": {
        "operationId": "listPasskeys",
        "description": "Requires the real live user session. Returns safe credential metadata: id, name, device_type, created_at, last_used_at and backed_up. last_used_at is null before the first successfully verified authentication assertion. Credential IDs, public keys, counters and authentication material are excluded. The list is bounded to 20 credentials per user.",
        "x-required-scope": "sessions:validate",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "session_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  }
                },
                "required": [
                  "session_token"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "passkeys": {
                          "type": "array",
                          "maxItems": 20,
                          "items": {
                            "type": "object",
                            "additionalProperties": false,
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 1024
                              },
                              "name": {
                                "type": "string"
                              },
                              "device_type": {
                                "type": "string"
                              },
                              "rp_id": {
                                "type": "string"
                              },
                              "binding_kind": {
                                "enum": [
                                  "hosted",
                                  "embedded"
                                ]
                              },
                              "created_at": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "last_used_at": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "format": "date-time"
                              },
                              "backed_up": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "device_type",
                              "rp_id",
                              "binding_kind",
                              "created_at",
                              "last_used_at",
                              "backed_up"
                            ]
                          }
                        }
                      },
                      "required": [
                        "passkeys"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/passkeys/register/options": {
      "post": {
        "operationId": "beginPasskeyRegistration",
        "description": "Requires auth:login plus sessions:validate. Send exactly one of a recent complete session_token or a current primary authentication_token with next_step=enroll and methods including passkey for first-time enrollment. Primary enrollment requires no existing passkey or verified TOTP; a password-only continuation cannot replace or bypass an existing factor. Optional name and client_context are bound to the one-use attempt. Without client_context the canonical hosted RP is used; an embedded context must match the enabled, domain-verified App/environment configuration. RP ID is always server-selected, with no caller override. A discoverable credential and actual device User Verification (UV) are required. Options alone do not register a credential.",
        "x-required-scope": "auth:login + sessions:validate",
        "x-required-scopes": [
          "auth:login",
          "sessions:validate"
        ],
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "session_token": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024
                      },
                      "name": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 80,
                        "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
                        "description": "A user-chosen label, trimmed before validation. Control characters are rejected."
                      },
                      "client_context": {
                        "oneOf": [
                          {
                            "type": "object",
                            "additionalProperties": false,
                            "properties": {
                              "platform": {
                                "const": "web"
                              },
                              "origin": {
                                "type": "string",
                                "format": "uri",
                                "maxLength": 512
                              }
                            },
                            "required": [
                              "platform",
                              "origin"
                            ]
                          },
                          {
                            "type": "object",
                            "additionalProperties": false,
                            "properties": {
                              "platform": {
                                "const": "ios"
                              },
                              "app_id": {
                                "type": "string",
                                "minLength": 12,
                                "maxLength": 255
                              }
                            },
                            "required": [
                              "platform",
                              "app_id"
                            ]
                          },
                          {
                            "type": "object",
                            "additionalProperties": false,
                            "properties": {
                              "platform": {
                                "const": "android"
                              },
                              "package_name": {
                                "type": "string",
                                "minLength": 3,
                                "maxLength": 255
                              },
                              "certificate_sha256": {
                                "type": "string",
                                "minLength": 64,
                                "maxLength": 95
                              }
                            },
                            "required": [
                              "platform",
                              "package_name",
                              "certificate_sha256"
                            ]
                          }
                        ],
                        "description": "Select a client already authorized by this App/environment embedded Passkey configuration. RP ID is chosen by the server from the enabled, domain-verified configuration. Web origins must match the exact HTTPS allowlist; native identities must match configured association entries. Never accept arbitrary RP IDs from an end user."
                      }
                    },
                    "required": [
                      "session_token"
                    ]
                  },
                  {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "authentication_token": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024
                      },
                      "name": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 80,
                        "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
                        "description": "A user-chosen label, trimmed before validation. Control characters are rejected."
                      },
                      "client_context": {
                        "oneOf": [
                          {
                            "type": "object",
                            "additionalProperties": false,
                            "properties": {
                              "platform": {
                                "const": "web"
                              },
                              "origin": {
                                "type": "string",
                                "format": "uri",
                                "maxLength": 512
                              }
                            },
                            "required": [
                              "platform",
                              "origin"
                            ]
                          },
                          {
                            "type": "object",
                            "additionalProperties": false,
                            "properties": {
                              "platform": {
                                "const": "ios"
                              },
                              "app_id": {
                                "type": "string",
                                "minLength": 12,
                                "maxLength": 255
                              }
                            },
                            "required": [
                              "platform",
                              "app_id"
                            ]
                          },
                          {
                            "type": "object",
                            "additionalProperties": false,
                            "properties": {
                              "platform": {
                                "const": "android"
                              },
                              "package_name": {
                                "type": "string",
                                "minLength": 3,
                                "maxLength": 255
                              },
                              "certificate_sha256": {
                                "type": "string",
                                "minLength": 64,
                                "maxLength": 95
                              }
                            },
                            "required": [
                              "platform",
                              "package_name",
                              "certificate_sha256"
                            ]
                          }
                        ],
                        "description": "Select a client already authorized by this App/environment embedded Passkey configuration. RP ID is chosen by the server from the enabled, domain-verified configuration. Web origins must match the exact HTTPS allowlist; native identities must match configured association entries. Never accept arbitrary RP IDs from an end user."
                      }
                    },
                    "required": [
                      "authentication_token"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "authentication_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "public_key": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "Standard WebAuthn options JSON generated for the canonical hosted RP by default, or for a configured and domain-verified embedded client_context. The server binds RP, origin, configuration revision and platform to the one-use ceremony. Pass these options unchanged to the browser or native credential API."
                        }
                      },
                      "required": [
                        "authentication_token",
                        "public_key"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/passkeys/register/verify": {
      "post": {
        "operationId": "finishPasskeyRegistration",
        "description": "Verify the browser registration response using the stored challenge and platform RP/origin. Ordinary session-authorized registration returns HTTP 200 with safe passkey metadata and reauthentication_required=true; previous sessions are invalidated. First-time enrollment from an eligible primary continuation returns HTTP 201 with reauthentication_required=false and a complete authentication session only after the current policy is satisfied. Inspect this discriminated response before establishing a business session. Neither response can be replayed to retrieve authentication after a lost result.",
        "x-required-scope": "auth:login + sessions:validate",
        "x-required-scopes": [
          "auth:login",
          "sessions:validate"
        ],
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "authentication_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "response": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024
                      },
                      "rawId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024
                      },
                      "type": {
                        "const": "public-key"
                      },
                      "authenticatorAttachment": {
                        "enum": [
                          "platform",
                          "cross-platform"
                        ]
                      },
                      "clientExtensionResults": {
                        "type": "object",
                        "additionalProperties": true
                      },
                      "response": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "clientDataJSON": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1024
                          },
                          "attestationObject": {
                            "type": "string",
                            "minLength": 1
                          },
                          "authenticatorData": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1024
                          },
                          "transports": {
                            "type": "array",
                            "items": {
                              "enum": [
                                "ble",
                                "cable",
                                "hybrid",
                                "internal",
                                "nfc",
                                "smart-card",
                                "usb"
                              ]
                            }
                          },
                          "publicKeyAlgorithm": {
                            "type": "integer"
                          },
                          "publicKey": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1024
                          }
                        },
                        "required": [
                          "clientDataJSON",
                          "attestationObject"
                        ]
                      }
                    },
                    "required": [
                      "id",
                      "rawId",
                      "type",
                      "clientExtensionResults",
                      "response"
                    ]
                  }
                },
                "required": [
                  "authentication_token",
                  "response"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "passkey": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1024
                            },
                            "name": {
                              "type": "string"
                            },
                            "device_type": {
                              "type": "string"
                            },
                            "rp_id": {
                              "type": "string"
                            },
                            "binding_kind": {
                              "enum": [
                                "hosted",
                                "embedded"
                              ]
                            },
                            "created_at": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "last_used_at": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "format": "date-time"
                            },
                            "backed_up": {
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "id",
                            "name",
                            "device_type",
                            "rp_id",
                            "binding_kind",
                            "created_at",
                            "last_used_at",
                            "backed_up"
                          ]
                        },
                        "reauthentication_required": {
                          "const": true
                        }
                      },
                      "required": [
                        "passkey",
                        "reauthentication_required"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "201": {
            "description": "First-time enrollment completed authentication. Use the returned session only after checking reauthentication_required=false.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "passkey": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1024
                            },
                            "name": {
                              "type": "string"
                            },
                            "device_type": {
                              "type": "string"
                            },
                            "rp_id": {
                              "type": "string"
                            },
                            "binding_kind": {
                              "enum": [
                                "hosted",
                                "embedded"
                              ]
                            },
                            "created_at": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "last_used_at": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "format": "date-time"
                            },
                            "backed_up": {
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "id",
                            "name",
                            "device_type",
                            "rp_id",
                            "binding_kind",
                            "created_at",
                            "last_used_at",
                            "backed_up"
                          ]
                        },
                        "reauthentication_required": {
                          "const": false
                        },
                        "authentication": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "session_id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1024
                            },
                            "user_id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1024
                            },
                            "external_user_id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1024
                            },
                            "expires_at": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "absolute_expires_at": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "session_token": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1024
                            }
                          },
                          "required": [
                            "session_id",
                            "user_id",
                            "external_user_id",
                            "expires_at",
                            "absolute_expires_at",
                            "session_token"
                          ]
                        }
                      },
                      "required": [
                        "passkey",
                        "reauthentication_required",
                        "authentication"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/passkeys/authentication/options": {
      "post": {
        "operationId": "beginPasskeyLogin",
        "description": "Begin discoverable passkey authentication for this App/environment. An empty JSON object selects the canonical hosted RP. Optional client_context selects an enabled, domain-verified embedded configuration and a previously allowed web origin or native app identity. Configuration revision is bound through the ceremony, MFA continuation and resulting session; changing or disabling it invalidates dependent attempts and sessions. Device User Verification (UV) is always required. Raw rp_id, free-form expected origins, usernames and user IDs are not accepted.",
        "x-required-scope": "auth:login",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "client_context": {
                    "oneOf": [
                      {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "platform": {
                            "const": "web"
                          },
                          "origin": {
                            "type": "string",
                            "format": "uri",
                            "maxLength": 512
                          }
                        },
                        "required": [
                          "platform",
                          "origin"
                        ]
                      },
                      {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "platform": {
                            "const": "ios"
                          },
                          "app_id": {
                            "type": "string",
                            "minLength": 12,
                            "maxLength": 255
                          }
                        },
                        "required": [
                          "platform",
                          "app_id"
                        ]
                      },
                      {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "platform": {
                            "const": "android"
                          },
                          "package_name": {
                            "type": "string",
                            "minLength": 3,
                            "maxLength": 255
                          },
                          "certificate_sha256": {
                            "type": "string",
                            "minLength": 64,
                            "maxLength": 95
                          }
                        },
                        "required": [
                          "platform",
                          "package_name",
                          "certificate_sha256"
                        ]
                      }
                    ],
                    "description": "Select a client already authorized by this App/environment embedded Passkey configuration. RP ID is chosen by the server from the enabled, domain-verified configuration. Web origins must match the exact HTTPS allowlist; native identities must match configured association entries. Never accept arbitrary RP IDs from an end user."
                  }
                },
                "required": []
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "authentication_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "public_key": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "Standard WebAuthn options JSON generated for the canonical hosted RP by default, or for a configured and domain-verified embedded client_context. The server binds RP, origin, configuration revision and platform to the one-use ceremony. Pass these options unchanged to the browser or native credential API."
                        }
                      },
                      "required": [
                        "authentication_token",
                        "public_key"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/passkeys/authentication/verify": {
      "post": {
        "operationId": "finishPasskeyLogin",
        "description": "Verify the WebAuthn signature/challenge/origin/RP and actual user verification result. Presence-only responses are rejected; verified UV is always required. It satisfies MFA by itself only when the customer policy permits it. Returns a session or a 202 MFA/enrollment continuation; never trust a client-supplied UV flag.",
        "x-required-scope": "auth:login",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "authentication_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "response": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024
                      },
                      "rawId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024
                      },
                      "type": {
                        "const": "public-key"
                      },
                      "authenticatorAttachment": {
                        "enum": [
                          "platform",
                          "cross-platform"
                        ]
                      },
                      "clientExtensionResults": {
                        "type": "object",
                        "additionalProperties": true
                      },
                      "response": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "clientDataJSON": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1024
                          },
                          "authenticatorData": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1024
                          },
                          "signature": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1024
                          },
                          "userHandle": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1024
                          }
                        },
                        "required": [
                          "clientDataJSON",
                          "authenticatorData",
                          "signature"
                        ]
                      }
                    },
                    "required": [
                      "id",
                      "rawId",
                      "type",
                      "clientExtensionResults",
                      "response"
                    ]
                  }
                },
                "required": [
                  "authentication_token",
                  "response"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Replay returns the previously completed live session.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "session_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "external_user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "absolute_expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "session_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        }
                      },
                      "required": [
                        "session_id",
                        "user_id",
                        "external_user_id",
                        "expires_at",
                        "absolute_expires_at",
                        "session_token"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "201": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "session_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "external_user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "absolute_expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "session_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        }
                      },
                      "required": [
                        "session_id",
                        "user_id",
                        "external_user_id",
                        "expires_at",
                        "absolute_expires_at",
                        "session_token"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "202": {
            "description": "Authentication is incomplete. Keep the continuation in the protected sign-in attempt. No session_token is returned and no business access may be granted.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "authentication_required": {
                          "const": true
                        },
                        "authentication_token": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "next_step": {
                          "enum": [
                            "mfa",
                            "enroll"
                          ]
                        },
                        "methods": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "totp",
                              "recovery_code",
                              "passkey"
                            ]
                          },
                          "description": "Use only methods explicitly offered. With next_step=enroll, passkey permits first-time discoverable enrollment only when no passkey or verified TOTP exists and policy accepts verified user verification as MFA. With next_step=mfa and methods=[passkey], restart authentication with an existing passkey; this primary continuation cannot add a new factor."
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        }
                      },
                      "required": [
                        "authentication_required",
                        "authentication_token",
                        "next_step",
                        "methods",
                        "expires_at"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/passkeys/delete": {
      "post": {
        "operationId": "deletePasskey",
        "description": "Requires auth:login plus sessions:validate and a recent user session. The credential must belong to that session user. Required MFA can prevent removal of the last usable factor. Successful removal invalidates previous sessions and requires fresh sign-in.",
        "x-required-scope": "auth:login + sessions:validate",
        "x-required-scopes": [
          "auth:login",
          "sessions:validate"
        ],
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "session_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "passkey_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  }
                },
                "required": [
                  "session_token",
                  "passkey_id"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "deleted": {
                          "const": true
                        },
                        "reauthentication_required": {
                          "const": true
                        }
                      },
                      "required": [
                        "deleted",
                        "reauthentication_required"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/passkeys/rename": {
      "post": {
        "operationId": "renamePasskey",
        "description": "Requires auth:login plus sessions:validate and the actual user's recent complete session. Updates only an owned passkey's display name. The name is trimmed, must contain 1–80 characters and cannot contain control characters. Returns the updated safe metadata. Renaming does not invalidate sessions or change the credential.",
        "x-required-scope": "auth:login + sessions:validate",
        "x-required-scopes": [
          "auth:login",
          "sessions:validate"
        ],
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "session_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "passkey_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 80,
                    "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
                    "description": "A user-chosen label, trimmed before validation. Control characters are rejected."
                  }
                },
                "required": [
                  "session_token",
                  "passkey_id",
                  "name"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "passkey": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1024
                            },
                            "name": {
                              "type": "string"
                            },
                            "device_type": {
                              "type": "string"
                            },
                            "rp_id": {
                              "type": "string"
                            },
                            "binding_kind": {
                              "enum": [
                                "hosted",
                                "embedded"
                              ]
                            },
                            "created_at": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "last_used_at": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "format": "date-time"
                            },
                            "backed_up": {
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "id",
                            "name",
                            "device_type",
                            "rp_id",
                            "binding_kind",
                            "created_at",
                            "last_used_at",
                            "backed_up"
                          ]
                        }
                      },
                      "required": [
                        "passkey"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/social/connections": {
      "post": {
        "operationId": "listSocialConnections",
        "description": "List this authenticated user's linked Google, GitHub and Apple identities. Requires a live session and sessions:validate. No provider subject, client secret, access token or refresh token is returned. Browser authorization and explicit linking use the platform-hosted OIDC flow; this endpoint cannot sign a user in.",
        "x-required-scope": "sessions:validate",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "session_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  }
                },
                "required": [
                  "session_token"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "connections": {
                          "type": "array",
                          "maxItems": 3,
                          "items": {
                            "type": "object",
                            "additionalProperties": false,
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 1024
                              },
                              "provider": {
                                "enum": [
                                  "google",
                                  "github",
                                  "apple"
                                ]
                              },
                              "email": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "created_at": {
                                "type": "string",
                                "format": "date-time"
                              }
                            },
                            "required": [
                              "id",
                              "provider",
                              "email",
                              "created_at"
                            ]
                          }
                        }
                      },
                      "required": [
                        "connections"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/social/unlink": {
      "post": {
        "operationId": "unlinkSocialConnection",
        "description": "Requires auth:login, sessions:validate and the actual user's complete session created within the last five minutes. Atomically removes an owned connection, advances the security version and requires reauthentication. The last usable primary login method cannot be removed. No automatic retries: after an uncertain result, reauthenticate and read the remaining connections.",
        "x-required-scope": "auth:login + sessions:validate",
        "x-required-scopes": [
          "auth:login",
          "sessions:validate"
        ],
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "session_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "connection_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  }
                },
                "required": [
                  "session_token",
                  "connection_id"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "deleted": {
                          "const": true
                        },
                        "reauthentication_required": {
                          "const": true
                        }
                      },
                      "required": [
                        "deleted",
                        "reauthentication_required"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/sessions/validate": {
      "post": {
        "operationId": "validateSession",
        "x-required-scope": "sessions:validate",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "session_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  }
                },
                "required": [
                  "session_token"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "oneOf": [
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "active": {
                              "const": false
                            }
                          },
                          "required": [
                            "active"
                          ]
                        },
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "active": {
                              "const": true
                            },
                            "session_id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1024
                            },
                            "user_id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1024
                            },
                            "external_user_id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1024
                            },
                            "expires_at": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "absolute_expires_at": {
                              "type": "string",
                              "format": "date-time"
                            }
                          },
                          "required": [
                            "active",
                            "session_id",
                            "user_id",
                            "external_user_id",
                            "expires_at",
                            "absolute_expires_at"
                          ]
                        }
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/sessions/context": {
      "post": {
        "operationId": "getSessionContext",
        "description": "Requires all three scopes: sessions:validate, users:read and metadata:read. Performs one live session validation and returns its SessionView, the existing UserView projection and current UserMetadata. Missing, expired, revoked, disabled or security-version-invalid sessions return only active=false. email_verified is returned without changing the validateSession eligibility rules; consumers that require verified email must enforce it. Never returns session_token, service credentials, password data or internal safety fields. Records activity once, never refreshes expiry, and uses the existing validation request-admission budget. Database failures remain 503, not active=false.",
        "x-required-scope": "sessions:validate + users:read + metadata:read",
        "x-required-scopes": [
          "sessions:validate",
          "users:read",
          "metadata:read"
        ],
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "session_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  }
                },
                "required": [
                  "session_token"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "oneOf": [
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "active": {
                              "const": false
                            }
                          },
                          "required": [
                            "active"
                          ]
                        },
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "active": {
                              "const": true
                            },
                            "session": {
                              "type": "object",
                              "additionalProperties": false,
                              "properties": {
                                "session_id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 1024
                                },
                                "user_id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 1024
                                },
                                "external_user_id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 1024
                                },
                                "expires_at": {
                                  "type": "string",
                                  "format": "date-time"
                                },
                                "absolute_expires_at": {
                                  "type": "string",
                                  "format": "date-time"
                                }
                              },
                              "required": [
                                "session_id",
                                "user_id",
                                "external_user_id",
                                "expires_at",
                                "absolute_expires_at"
                              ]
                            },
                            "user": {
                              "type": "object",
                              "additionalProperties": false,
                              "properties": {
                                "user_id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 1024
                                },
                                "external_user_id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 1024
                                },
                                "email": {
                                  "type": "string",
                                  "format": "email",
                                  "maxLength": 254
                                },
                                "email_verified": {
                                  "type": "boolean"
                                },
                                "disabled": {
                                  "type": "boolean"
                                },
                                "name": {
                                  "type": "string"
                                },
                                "image": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "created_at": {
                                  "type": "string",
                                  "format": "date-time"
                                },
                                "updated_at": {
                                  "type": "string",
                                  "format": "date-time"
                                }
                              },
                              "required": [
                                "user_id",
                                "external_user_id",
                                "email",
                                "email_verified",
                                "disabled",
                                "name",
                                "image",
                                "created_at",
                                "updated_at"
                              ]
                            },
                            "metadata": {
                              "type": "object",
                              "additionalProperties": false,
                              "properties": {
                                "revision": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "description": "Use the current revision when replacing metadata. Zero indicates that no metadata has been written."
                                },
                                "profile_metadata": {
                                  "type": "object",
                                  "additionalProperties": true,
                                  "description": "JSON object of at most 6144 UTF-8 bytes after compact serialization. Replacement stores the complete object; include existing keys to preserve them, or send {} to clear the object. User profile and preferences, stored in user_metadata.profile_metadata."
                                },
                                "managed_metadata": {
                                  "type": "object",
                                  "additionalProperties": true,
                                  "description": "JSON object of at most 6144 UTF-8 bytes after compact serialization. Replacement stores the complete object; include existing keys to preserve them, or send {} to clear the object. User attributes managed by the application, stored in user_metadata.managed_metadata."
                                }
                              },
                              "required": [
                                "revision",
                                "profile_metadata",
                                "managed_metadata"
                              ]
                            }
                          },
                          "required": [
                            "active",
                            "session",
                            "user",
                            "metadata"
                          ]
                        }
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/sessions/refresh": {
      "post": {
        "operationId": "refreshSession",
        "x-required-scope": "sessions:refresh",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{8,128}$"
            },
            "description": "Persist with the operation and reuse with the same payload after timeout."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "session_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  }
                },
                "required": [
                  "session_token"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "session_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "external_user_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1024
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "absolute_expires_at": {
                          "type": "string",
                          "format": "date-time"
                        }
                      },
                      "required": [
                        "session_id",
                        "user_id",
                        "external_user_id",
                        "expires_at",
                        "absolute_expires_at"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/sessions/revoke": {
      "post": {
        "operationId": "revokeSession",
        "x-required-scope": "sessions:revoke",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "session_token": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  }
                },
                "required": [
                  "session_token"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "revoked": {
                          "const": true
                        }
                      },
                      "required": [
                        "revoked"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/password-resets": {
      "post": {
        "operationId": "resetPassword",
        "x-required-scope": "auth:password_reset",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{8,128}$"
            },
            "description": "Persist with the operation and reuse with the same payload after timeout."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "external_user_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "authentication_proof": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "new_password": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 128
                  }
                },
                "required": [
                  "external_user_id",
                  "authentication_proof",
                  "new_password"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "reset": {
                          "const": true
                        }
                      },
                      "required": [
                        "reset"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/users/{userId}/sessions/revoke": {
      "post": {
        "operationId": "revokeUserSessions",
        "x-required-scope": "users:sessions:revoke",
        "security": [
          {
            "serviceCredential": []
          }
        ],
        "parameters": [
          {
            "name": "X-Virtneu-Auth-Application",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Virtneu-Auth-Environment",
            "in": "header",
            "required": true,
            "schema": {
              "enum": [
                "test",
                "production"
              ]
            }
          },
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "all": {
                    "const": true
                  }
                },
                "required": [
                  "all"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success. Cache-Control: no-store.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "revoked": {
                          "const": true
                        }
                      },
                      "required": [
                        "revoked"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured service error. No secrets or raw provider messages. 403 PASSWORD_AUTH_DISABLED means the selected environment disables password registration, sign-in, resets and reset-code issuance.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Server-generated identifier for this HTTP attempt; incoming IDs are ignored. Matches request_id in the JSON envelope, including errors and 413. Retries receive a new ID; this is not an idempotency key."
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds for applicable rate limits."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/ready": {
      "get": {
        "operationId": "getRuntimeReadiness",
        "security": [],
        "description": "Read-only runtime readiness: real routing configuration, tenant-key encryption round trip and primary control catalogue/schema queries. No customer tenant is selected. This probe does not assert external or per-tenant acceptance; use /v1/integration/readiness plus the full functional monitor. Missing recovery control migration fails closed.",
        "responses": {
          "200": {
            "description": "Runtime checks passed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "readiness_version": {
                      "const": 1
                    },
                    "platform_env_id": {
                      "type": "string"
                    },
                    "scope": {
                      "enum": [
                        "runtime",
                        "tenant_configuration"
                      ]
                    },
                    "ready": {
                      "type": "boolean"
                    },
                    "checked_at": {
                      "type": "integer"
                    },
                    "checks": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1024
                          },
                          "status": {
                            "enum": [
                              "passed",
                              "failed"
                            ]
                          },
                          "code": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1024
                          }
                        },
                        "required": [
                          "name",
                          "status"
                        ]
                      }
                    },
                    "external_acceptance": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "inbox_delivery": {
                          "const": "not_evaluated"
                        },
                        "sustained_probe": {
                          "const": "not_evaluated"
                        },
                        "external_alert_delivery": {
                          "const": "not_evaluated"
                        },
                        "deployed_capacity": {
                          "const": "not_evaluated"
                        },
                        "provider_restore": {
                          "const": "not_evaluated"
                        }
                      },
                      "required": [
                        "inbox_delivery",
                        "sustained_probe",
                        "external_alert_delivery",
                        "deployed_capacity",
                        "provider_restore"
                      ]
                    }
                  },
                  "required": [
                    "readiness_version",
                    "scope",
                    "ready",
                    "checked_at",
                    "checks",
                    "external_acceptance"
                  ]
                }
              }
            }
          },
          "503": {
            "description": "One or more runtime checks failed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "readiness_version": {
                      "const": 1
                    },
                    "platform_env_id": {
                      "type": "string"
                    },
                    "scope": {
                      "enum": [
                        "runtime",
                        "tenant_configuration"
                      ]
                    },
                    "ready": {
                      "type": "boolean"
                    },
                    "checked_at": {
                      "type": "integer"
                    },
                    "checks": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1024
                          },
                          "status": {
                            "enum": [
                              "passed",
                              "failed"
                            ]
                          },
                          "code": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1024
                          }
                        },
                        "required": [
                          "name",
                          "status"
                        ]
                      }
                    },
                    "external_acceptance": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "inbox_delivery": {
                          "const": "not_evaluated"
                        },
                        "sustained_probe": {
                          "const": "not_evaluated"
                        },
                        "external_alert_delivery": {
                          "const": "not_evaluated"
                        },
                        "deployed_capacity": {
                          "const": "not_evaluated"
                        },
                        "provider_restore": {
                          "const": "not_evaluated"
                        }
                      },
                      "required": [
                        "inbox_delivery",
                        "sustained_probe",
                        "external_alert_delivery",
                        "deployed_capacity",
                        "provider_restore"
                      ]
                    }
                  },
                  "required": [
                    "readiness_version",
                    "scope",
                    "ready",
                    "checked_at",
                    "checks",
                    "external_acceptance"
                  ]
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "serviceCredential": {
        "type": "http",
        "scheme": "bearer",
        "description": "App/environment-scoped backend credential. Never substitute an end-user session token."
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "retryable": {
                "type": "boolean"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "code"
            ]
          },
          "request_id": {
            "type": "string"
          }
        },
        "required": [
          "error"
        ]
      }
    }
  }
}
