{
  "openapi": "3.0.3",
  "info": {
    "title": "Blimark Agent Readiness API",
    "version": "1.5.0",
    "description": "Private credential associated with an active account. API access is enabled by the operator; self-service key generation is not available. Effective permissions and limits belong to the associated account. Audit, read, export the native executive PDF and share owned reports. No administration. See api.md for retention, limits and resumable examples. businessModules optionally selects Commerce and payments and/or Agent interfaces; agent_interfaces requires profile application or full. Results are additive, evidence-backed and do not change core scores or maturity."
  },
  "servers": [
    {
      "url": "https://agentreadiness.blimark.tech"
    }
  ],
  "externalDocs": {
    "url": "https://agentreadiness.blimark.tech/documentacion/api.md"
  },
  "security": [
    {
      "ApiKey": []
    },
    {
      "BearerKey": []
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      },
      "BearerKey": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "AGENT_READINESS_API_KEY"
      }
    },
    "schemas": {
      "AuditStatus": {
        "type": "object",
        "required": [
          "id",
          "status",
          "scope",
          "cache",
          "versions",
          "createdAt",
          "startedAt",
          "completedAt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string",
            "enum": [
              "queued",
              "running",
              "completed",
              "partial",
              "failed",
              "cancelled"
            ]
          },
          "scope": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "profile": {
                "type": "string",
                "enum": [
                  "content",
                  "application",
                  "full"
                ]
              },
              "includeCommerce": {
                "type": "boolean",
                "description": "Legacy alias for selecting commerce_payments. Prefer businessModules."
              },
              "businessModules": {
                "type": "array",
                "uniqueItems": true,
                "maxItems": 2,
                "description": "Optional business modules; agent_interfaces requires profile application or full.",
                "items": {
                  "type": "string",
                  "enum": ["commerce_payments", "agent_interfaces"]
                }
              },
              "device": {
                "type": "string",
                "enum": [
                  "mobile"
                ]
              },
              "includeLighthouse": {
                "type": "boolean",
                "description": "Whether Lighthouse was requested."
              },
              "contextualAssessment": {
                "type": "boolean",
                "description": "Whether an independent contextual assessment was requested."
              }
            },
            "required": [
              "url",
              "profile",
              "includeCommerce",
              "businessModules",
              "device",
              "includeLighthouse",
              "contextualAssessment"
            ]
          },
          "cache": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "hit": {
                "type": "boolean"
              },
              "observedAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true
              },
              "expiresAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true
              }
            },
            "required": [
              "hit",
              "observedAt",
              "expiresAt"
            ]
          },
          "versions": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "schema": {
                "type": "string"
              },
              "engine": {
                "type": "string"
              },
              "ruleset": {
                "type": "string"
              }
            },
            "required": [
              "schema",
              "engine",
              "ruleset"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "startedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "dispatch": {
            "type": "string",
            "enum": [
              "published",
              "pending",
              "already_accepted"
            ]
          }
        },
        "additionalProperties": false
      },
      "BusinessContext": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "family",
          "modules"
        ],
        "description": "Enum-only request context. No free text, evidence, observations, customer data, or credentials. Targets defaults to an empty array.",
        "properties": {
          "family": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "primary",
              "secondary"
            ],
            "properties": {
              "primary": {
                "type": "string",
                "nullable": true,
                "enum": [
                  "services",
                  "products",
                  "institutions",
                  "content_community"
                ]
              },
              "secondary": {
                "type": "array",
                "uniqueItems": true,
                "maxItems": 4,
                "items": {
                  "type": "string",
                  "enum": [
                    "services",
                    "products",
                    "institutions",
                    "content_community"
                  ]
                }
              }
            }
          },
          "modules": {
            "type": "array",
            "maxItems": 6,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "id",
                "availability"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "enum": [
                    "lead_contact",
                    "bookings",
                    "commerce_payments",
                    "private_accounts_operations",
                    "requests_tracking",
                    "first_party_agent"
                  ]
                },
                "availability": {
                  "type": "string",
                  "enum": [
                    "offered",
                    "not_offered",
                    "undecided"
                  ]
                }
              }
            }
          },
          "targets": {
            "type": "array",
            "maxItems": 6,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "moduleId",
                "priority"
              ],
              "properties": {
                "moduleId": {
                  "type": "string",
                  "enum": [
                    "lead_contact",
                    "bookings",
                    "commerce_payments",
                    "private_accounts_operations",
                    "requests_tracking",
                    "first_party_agent"
                  ]
                },
                "priority": {
                  "type": "string",
                  "enum": [
                    "later",
                    "planned",
                    "near_term"
                  ]
                }
              }
            }
          }
        }
      },
      "ContextualAssessment": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "profileVersion",
          "rulesVersion",
          "discoveryState",
          "controls",
          "summary",
          "context"
        ],
        "properties": {
          "profileVersion": {
            "type": "string",
            "enum": [
              "contextual-assessment/0.1.0-draft"
            ]
          },
          "rulesVersion": {
            "type": "string",
            "enum": [
              "contextual-rules/0.1.0-draft"
            ]
          },
          "discoveryState": {
            "type": "string",
            "enum": [
              "complete",
              "provisional",
              "insufficient_evidence"
            ]
          },
          "controls": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "controlId",
                "applicability",
                "weight",
                "creditGroup",
                "evidenceRefs",
                "verificationMode",
                "evidenceLevel",
                "predicateId",
                "criticality"
              ],
              "properties": {
                "controlId": {
                  "type": "string",
                  "pattern": "^[a-z][a-z0-9_.-]{1,95}$",
                  "maxLength": 96
                },
                "applicability": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "state",
                    "reason"
                  ],
                  "properties": {
                    "state": {
                      "type": "string",
                      "enum": [
                        "applies",
                        "not_applicable",
                        "unknown"
                      ]
                    },
                    "reason": {
                      "type": "string",
                      "pattern": "^[a-z][a-z0-9_.-]{1,95}$",
                      "maxLength": 96
                    }
                  }
                },
                "outcome": {
                  "type": "string",
                  "enum": [
                    "pass",
                    "fail",
                    "unable_to_check",
                    "informational"
                  ]
                },
                "weight": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 100
                },
                "creditGroup": {
                  "type": "string",
                  "pattern": "^[a-z][a-z0-9_.-]{1,95}$",
                  "maxLength": 96
                },
                "evidenceRefs": {
                  "type": "array",
                  "maxItems": 16,
                  "items": {
                    "type": "string",
                    "pattern": "^ev_[A-Za-z0-9_-]{6,80}$"
                  }
                },
                "verificationMode": {
                  "type": "string",
                  "enum": [
                    "discovery",
                    "authorized_functional",
                    "internal_audit"
                  ]
                },
                "evidenceLevel": {
                  "type": "string",
                  "enum": [
                    "user_declaration",
                    "public_declaration",
                    "static_public",
                    "protocol_discovery",
                    "functional_authorized",
                    "internal_verified"
                  ]
                },
                "predicateId": {
                  "type": "string",
                  "pattern": "^[a-z][a-z0-9_.-]{1,95}$",
                  "maxLength": 96
                },
                "criticality": {
                  "type": "string",
                  "enum": [
                    "none",
                    "low",
                    "medium",
                    "high",
                    "critical"
                  ]
                },
                "blockerCode": {
                  "type": "string",
                  "pattern": "^[a-z][a-z0-9_.-]{1,95}$",
                  "maxLength": 96
                },
                "confirmationBasis": {
                  "type": "string",
                  "enum": [
                    "direct_public_security_exposure",
                    "authorized_functional",
                    "internal_verified",
                    "discovery_only"
                  ]
                }
              }
            }
          },
          "summary": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "discoveryScoreObserved",
              "discoveryCoverage",
              "minimumDiscoveryCoverage",
              "possibleInterval",
              "unknownApplicabilityIds",
              "functionalVerificationStatus",
              "evidenceGaps",
              "criticalEvidenceGaps",
              "confirmedCriticalFailures",
              "assessmentMode",
              "evidenceLevels",
              "criticalObservations"
            ],
            "properties": {
              "discoveryScoreObserved": {
                "type": "number",
                "nullable": true,
                "minimum": 0,
                "maximum": 100
              },
              "discoveryCoverage": {
                "type": "number",
                "nullable": true,
                "minimum": 0,
                "maximum": 1
              },
              "minimumDiscoveryCoverage": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              },
              "possibleInterval": {
                "type": "object",
                "nullable": true,
                "additionalProperties": false,
                "required": [
                  "low",
                  "high"
                ],
                "properties": {
                  "low": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "high": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  }
                }
              },
              "unknownApplicabilityIds": {
                "type": "array",
                "maxItems": 64,
                "items": {
                  "type": "string",
                  "pattern": "^[a-z][a-z0-9_.-]{1,95}$",
                  "maxLength": 96
                }
              },
              "functionalVerificationStatus": {
                "type": "string",
                "enum": [
                  "not_performed"
                ]
              },
              "evidenceGaps": {
                "type": "array",
                "maxItems": 64,
                "items": {
                  "type": "string",
                  "pattern": "^[a-z][a-z0-9_.-]{1,95}$",
                  "maxLength": 96
                }
              },
              "criticalEvidenceGaps": {
                "type": "array",
                "maxItems": 64,
                "items": {
                  "type": "string",
                  "pattern": "^[a-z][a-z0-9_.-]{1,95}$",
                  "maxLength": 96
                }
              },
              "confirmedCriticalFailures": {
                "type": "array",
                "maxItems": 64,
                "items": {
                  "type": "string",
                  "pattern": "^[a-z][a-z0-9_.-]{1,95}$",
                  "maxLength": 96
                }
              },
              "assessmentMode": {
                "type": "string",
                "enum": [
                  "discovery"
                ]
              },
              "evidenceLevels": {
                "type": "array",
                "maxItems": 64,
                "items": {
                  "type": "string",
                  "enum": [
                    "user_declaration",
                    "public_declaration",
                    "static_public",
                    "protocol_discovery",
                    "functional_authorized",
                    "internal_verified"
                  ]
                }
              },
              "criticalObservations": {
                "type": "array",
                "maxItems": 64,
                "items": {
                  "type": "string",
                  "pattern": "^[a-z][a-z0-9_.-]{1,95}$",
                  "maxLength": 96
                }
              }
            }
          },
          "context": {
            "$ref": "#/components/schemas/BusinessContext"
          }
        }
      },
      "BusinessModuleAssessment": {
        "type": "object",
        "additionalProperties": false,
        "required": ["version", "requested", "results"],
        "properties": {
          "version": {"type": "string", "enum": ["business-modules/1.0.0"]},
          "requested": {
            "type": "array", "uniqueItems": true, "maxItems": 2,
            "items": {"type": "string", "enum": ["commerce_payments", "agent_interfaces"]}
          },
          "results": {
            "type": "array", "maxItems": 2,
            "items": {
              "type": "object", "additionalProperties": false,
              "required": ["id", "selected", "state", "evidenceCheckIds"],
              "properties": {
                "id": {"type": "string", "enum": ["commerce_payments", "agent_interfaces"]},
                "selected": {"type": "boolean"},
                "state": {"type": "string", "enum": ["detected", "no_public_evidence", "unable_to_check"]},
                "evidenceCheckIds": {"type": "array", "maxItems": 24, "uniqueItems": true, "items": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"}}
              }
            }
          }
        }
      }
    }
  },
  "paths": {
    "/api/v1/audits/{id}": {
      "get": {
        "operationId": "getAuditStatus",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "Origin",
            "in": "header",
            "required": false,
            "description": "Omit for server-to-server. If present must equal the request API origin exactly; foreign or null Origin is rejected with 403 for all API methods. Authentication is still mandatory.",
            "schema": {
              "type": "string",
              "enum": [
                "https://agentreadiness.blimark.tech"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AuditStatus"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input"
          },
          "401": {
            "description": "Invalid or expired key / inactive associated account"
          },
          "403": {
            "description": "Forbidden scope or origin"
          },
          "404": {
            "description": "Missing or not owned"
          },
          "409": {
            "description": "Report not ready"
          },
          "410": {
            "description": "Expired or unavailable"
          },
          "429": {
            "description": "Rate/quota limit",
            "headers": {
              "Retry-After": {
                "description": "Seconds until retry, when supplied",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              }
            }
          },
          "503": {
            "description": "Capacity busy: honor Retry-After",
            "headers": {
              "Retry-After": {
                "description": "Seconds until retry, when supplied",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/audits/{id}/report": {
      "get": {
        "operationId": "getAuditReport",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "Origin",
            "in": "header",
            "required": false,
            "description": "Omit for server-to-server. If present must equal the request API origin exactly; foreign or null Origin is rejected with 403 for all API methods. Authentication is still mandatory.",
            "schema": {
              "type": "string",
              "enum": [
                "https://agentreadiness.blimark.tech"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "report": {
                      "type": "object",
                      "additionalProperties": true,
                      "properties": {
                        "contextualAssessment": {
                          "$ref": "#/components/schemas/ContextualAssessment"
                        },
                        "businessModules": {
                          "type": "array",
                          "items": {"type": "string", "enum": ["commerce_payments", "agent_interfaces"]}
                        },
                        "businessModuleAssessment": {
                          "$ref": "#/components/schemas/BusinessModuleAssessment"
                        }
                      },
                      "description": "Report fields vary by audit scope. businessModuleAssessment explains selected or positively detected modules; it is score-neutral."
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Invalid input"
          },
          "401": {
            "description": "Invalid or expired key / inactive associated account"
          },
          "403": {
            "description": "Forbidden scope or origin"
          },
          "404": {
            "description": "Missing or not owned"
          },
          "409": {
            "description": "Report not ready"
          },
          "410": {
            "description": "Expired or unavailable"
          },
          "429": {
            "description": "Rate/quota limit",
            "headers": {
              "Retry-After": {
                "description": "Seconds until retry, when supplied",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              }
            }
          },
          "503": {
            "description": "Capacity busy: honor Retry-After",
            "headers": {
              "Retry-After": {
                "description": "Seconds until retry, when supplied",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/audits/{id}/export-options": {
      "get": {
        "operationId": "getExportOptions",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "Origin",
            "in": "header",
            "required": false,
            "description": "Omit for server-to-server. If present must equal the request API origin exactly; foreign or null Origin is rejected with 403 for all API methods. Authentication is still mandatory.",
            "schema": {
              "type": "string",
              "enum": [
                "https://agentreadiness.blimark.tech"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "pdf": {
                      "type": "boolean"
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Invalid input"
          },
          "401": {
            "description": "Invalid or expired key / inactive associated account"
          },
          "403": {
            "description": "Forbidden scope or origin"
          },
          "404": {
            "description": "Missing or not owned"
          },
          "409": {
            "description": "Report not ready"
          },
          "410": {
            "description": "Expired or unavailable"
          },
          "429": {
            "description": "Rate/quota limit",
            "headers": {
              "Retry-After": {
                "description": "Seconds until retry, when supplied",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              }
            }
          },
          "503": {
            "description": "Capacity busy: honor Retry-After",
            "headers": {
              "Retry-After": {
                "description": "Seconds until retry, when supplied",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/audits/{id}/share": {
      "post": {
        "operationId": "createShareLink",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "Origin",
            "in": "header",
            "required": false,
            "description": "Omit for server-to-server. If present must equal the request API origin exactly; foreign or null Origin is rejected with 403 for all API methods. Authentication is still mandatory.",
            "schema": {
              "type": "string",
              "enum": [
                "https://agentreadiness.blimark.tech"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "url",
                    "expiresAt"
                  ],
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "expiresAt": {
                      "type": "string",
                      "format": "date-time"
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Invalid input"
          },
          "401": {
            "description": "Invalid or expired key / inactive associated account"
          },
          "403": {
            "description": "Forbidden scope or origin"
          },
          "404": {
            "description": "Missing or not owned"
          },
          "409": {
            "description": "Report not ready"
          },
          "410": {
            "description": "Expired or unavailable"
          },
          "429": {
            "description": "Rate/quota limit",
            "headers": {
              "Retry-After": {
                "description": "Seconds until retry, when supplied",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              }
            }
          },
          "503": {
            "description": "Capacity busy: honor Retry-After",
            "headers": {
              "Retry-After": {
                "description": "Seconds until retry, when supplied",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              }
            }
          }
        },
        "description": "30 requests per fixed UTC minute per account (sessions + API). One persisted link per audit; original expiry is not renewed."
      }
    },
    "/api/v1/audits/{id}/pdf": {
      "post": {
        "operationId": "downloadExecutivePdf",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "Origin",
            "in": "header",
            "required": false,
            "description": "Omit for server-to-server. If present must equal the request API origin exactly; foreign or null Origin is rejected with 403 for all API methods. Authentication is still mandatory.",
            "schema": {
              "type": "string",
              "enum": [
                "https://agentreadiness.blimark.tech"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Native executive PDF, identical renderer to web app",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input"
          },
          "401": {
            "description": "Invalid or expired key / inactive associated account"
          },
          "403": {
            "description": "Forbidden scope or origin"
          },
          "404": {
            "description": "Missing or not owned"
          },
          "409": {
            "description": "Report not ready"
          },
          "410": {
            "description": "Expired or unavailable"
          },
          "429": {
            "description": "Rate/quota limit",
            "headers": {
              "Retry-After": {
                "description": "Seconds until retry, when supplied",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              }
            }
          },
          "503": {
            "description": "Capacity busy: honor Retry-After",
            "headers": {
              "Retry-After": {
                "description": "Seconds until retry, when supplied",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              }
            }
          },
          "422": {
            "description": "Report too large to export"
          }
        },
        "description": "10 requests per fixed UTC minute per account (sessions + API), including cached PDFs. Global generation lock also applies."
      }
    },
    "/api/v1/audits": {
      "post": {
        "operationId": "createAudit",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Persist and reuse for retries of the same request",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          },
          {
            "name": "Origin",
            "in": "header",
            "required": false,
            "description": "Omit for server-to-server. If present must equal the request API origin exactly; foreign or null Origin is rejected with 403 for all API methods. Authentication is still mandatory.",
            "schema": {
              "type": "string",
              "enum": [
                "https://agentreadiness.blimark.tech"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "url",
                  "profile"
                ],
                "properties": {
                  "url": {
                    "type": "string",
                    "format": "uri",
                    "example": "https://example.com/",
                    "pattern": "^[hH][tT][tT][pP][sS]?://",
                    "maxLength": 2048,
                    "minLength": 1
                  },
                  "profile": {
                    "type": "string",
                    "enum": [
                      "content",
                      "application",
                      "full"
                    ]
                  },
                  "device": {
                    "type": "string",
                    "enum": [
                      "mobile"
                    ]
                  },
                  "includeCommerce": {
                    "type": "boolean",
                    "default": false,
                    "description": "Legacy alias for selecting commerce_payments. Prefer businessModules."
                  },
                  "businessModules": {
                    "type": "array",
                    "uniqueItems": true,
                    "maxItems": 2,
                    "description": "Optional business modules; agent_interfaces requires profile application or full.",
                    "items": {
                      "type": "string",
                      "enum": ["commerce_payments", "agent_interfaces"]
                    },
                    "description": "Optional business modules. Omitted or empty runs the general audit only."
                  },
                  "includeLighthouse": {
                    "type": "boolean",
                    "default": false,
                    "description": "Opt in to Lighthouse. Omitted or false runs Agent Readiness without Lighthouse or CrUX."
                  },
                  "businessContext": {
                    "$ref": "#/components/schemas/BusinessContext"
                  }
                },
                "additionalProperties": false,
                "description": "General audit with optional business modules and independently optional Lighthouse. The legacy businessContext field remains accepted for compatibility."
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AuditStatus"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input"
          },
          "401": {
            "description": "Invalid or expired key / inactive associated account"
          },
          "403": {
            "description": "Forbidden scope or origin"
          },
          "404": {
            "description": "Missing or not owned"
          },
          "409": {
            "description": "Idempotency key reused with a different request or contextual scope"
          },
          "410": {
            "description": "Expired or unavailable"
          },
          "429": {
            "description": "Rate/quota limit",
            "headers": {
              "Retry-After": {
                "description": "Seconds until retry, when supplied",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              }
            }
          },
          "503": {
            "description": "Capacity busy: honor Retry-After",
            "headers": {
              "Retry-After": {
                "description": "Seconds until retry, when supplied",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              }
            }
          }
        },
        "description": "One active audit per account, shared by web and API; 10 new admission attempts per UTC minute. At most 3 active globally. Personal quotas plus safety budgets apply; see api.md. Existing idempotency keys do not create or count another audit."
      }
    }
  }
}
