{
  "openapi": "3.1.0",
  "info": {
    "title": "DeepForgery Pro API — Draft",
    "version": "1.0.0-draft",
    "description": "Illustrative outline for the documentation site. Request and response schemas are pending."
  },
  "security": [{ "apiKey": [] }],
  "paths": {
    "/v1/pro/analyses": {
      "post": {
        "operationId": "submitAnalysis",
        "summary": "Submit an analysis",
        "x-required-scope": "analyses:write",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": { "type": "string", "maxLength": 128 }
          }
        ],
        "responses": {
          "202": { "description": "Analysis accepted." }
        }
      }
    },
    "/v1/pro/analyses/{analysis_id}": {
      "parameters": [{ "$ref": "#/components/parameters/AnalysisId" }],
      "get": {
        "operationId": "getAnalysisStatus",
        "summary": "Get the analysis status",
        "x-required-scope": "analyses:read",
        "responses": {
          "200": { "description": "Current analysis status." }
        }
      },
      "delete": {
        "operationId": "deleteAnalysis",
        "summary": "Delete an analysis",
        "x-required-scope": "analyses:delete",
        "responses": {
          "204": { "description": "Analysis deleted." }
        }
      }
    },
    "/v1/pro/analyses/{analysis_id}/result": {
      "parameters": [{ "$ref": "#/components/parameters/AnalysisId" }],
      "get": {
        "operationId": "getAnalysisResult",
        "summary": "Get the analysis result",
        "x-required-scope": "analyses:read",
        "responses": {
          "200": { "description": "Analysis result." }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "AnalysisId": {
        "name": "analysis_id",
        "in": "path",
        "required": true,
        "schema": { "type": "string", "format": "uuid" }
      }
    },
    "securitySchemes": {
      "apiKey": { "type": "http", "scheme": "bearer" }
    }
  }
}
