{
  "openapi": "3.1.0",
  "info": {
    "title": "PostOpz Framework Agent API",
    "version": "0.3.0",
    "description": "Professional Avid Media Composer post-production workflow knowledge grounded in The PostOpz Framework Vol. 1. Autonomous agents can purchase task-scoped workflow guidance, implementation checklists, and workflow audits with USDC over x402 v2. Retrieval rights only; model training, fine-tuning, distillation, corpus ingestion, redistribution, and OEM rights are excluded.",
    "x-guidance": "Use POST /v1/x402/workflow/query for professional Avid workflow guidance, POST /v1/x402/workflow/checklist for task-specific assistant-editor and QC checklists, and POST /v1/x402/workflow/audit to evaluate structured project/workflow metadata. Send JSON. Do not include confidential source media or bulk corpus-extraction requests.",
    "termsOfService": "https://postopz.com/framework/agent/license/",
    "contact": {
      "name": "PostOpz",
      "email": "hello@postopz.com",
      "url": "https://postopz.com/framework/agent/"
    }
  },
  "servers": [
    { "url": "https://api.postopz.com", "description": "Canonical production API" }
  ],
  "paths": {
    "/v1/health": {
      "get": {
        "operationId": "postopzHealth",
        "summary": "Check PostOpz Agent API health",
        "responses": { "200": { "description": "Healthy service" } }
      }
    },
    "/v1/discover": {
      "get": {
        "operationId": "postopzDiscover",
        "summary": "Discover PostOpz Agent Edition plans and autonomous commerce endpoints",
        "responses": { "200": { "description": "Machine-readable product and commerce metadata" } }
      }
    },
    "/v1/x402/workflow/query": {
      "post": {
        "operationId": "postopzWorkflowQuery",
        "summary": "Professional Avid Media Composer workflow guidance",
        "description": "Task-scoped professional editorial workflow guidance grounded in PostOpz Framework Vol. 1.",
        "tags": ["Knowledge", "Post Production", "Avid Media Composer"],
        "x-payment-info": {
          "price": { "mode": "fixed", "currency": "USD", "amount": "0.500000" },
          "protocols": [{ "x402": {} }]
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["task"],
                "properties": {
                  "edition": { "type": "string", "enum": ["avid-vol1"], "default": "avid-vol1" },
                  "task": { "type": "string", "minLength": 1, "maxLength": 6000, "description": "The professional editorial workflow question or task." },
                  "desired_output": { "type": "string", "description": "Optional output preference such as structured_steps." },
                  "context": { "type": "object", "additionalProperties": true, "description": "Optional non-confidential production context." }
                }
              }
            }
          }
        },
        "responses": {
          "200": { "description": "Paid Framework-grounded workflow guidance" },
          "402": { "description": "Payment Required" },
          "429": { "description": "Burst limit reached" },
          "503": { "description": "Retrieval temporarily unavailable" }
        }
      }
    },
    "/v1/x402/workflow/checklist": {
      "post": {
        "operationId": "postopzWorkflowChecklist",
        "summary": "Avid assistant-editor implementation and QC checklist",
        "description": "Generate a task-specific implementation, handoff, or QC checklist grounded in PostOpz Framework Vol. 1.",
        "tags": ["Knowledge", "Post Production", "Assistant Editor", "Avid Media Composer"],
        "x-payment-info": {
          "price": { "mode": "fixed", "currency": "USD", "amount": "0.350000" },
          "protocols": [{ "x402": {} }]
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["task"],
                "properties": {
                  "task": { "type": "string", "minLength": 1, "maxLength": 6000, "description": "The assistant-editor or QC task to turn into a checklist." },
                  "context": { "type": "object", "additionalProperties": true, "description": "Optional non-confidential production context." }
                }
              }
            }
          }
        },
        "responses": {
          "200": { "description": "Paid structured checklist" },
          "402": { "description": "Payment Required" },
          "429": { "description": "Burst limit reached" },
          "503": { "description": "Retrieval temporarily unavailable" }
        }
      }
    },
    "/v1/x402/workflow/audit": {
      "post": {
        "operationId": "postopzWorkflowAudit",
        "summary": "Audit Avid project and workflow metadata",
        "description": "Evaluate structured Avid project/workflow metadata against PostOpz professional workflow standards and return risks and next actions.",
        "tags": ["Analyze", "Post Production", "Workflow Audit", "Avid Media Composer"],
        "x-payment-info": {
          "price": { "mode": "fixed", "currency": "USD", "amount": "0.750000" },
          "protocols": [{ "x402": {} }]
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "task": { "type": "string", "maxLength": 6000, "description": "What should be audited." },
                  "workflow_stage": { "type": "string" },
                  "project_metadata": { "type": "object", "additionalProperties": true, "description": "Structured, non-confidential project metadata." },
                  "context": { "type": "object", "additionalProperties": true }
                }
              }
            }
          }
        },
        "responses": {
          "200": { "description": "Paid structured audit findings" },
          "402": { "description": "Payment Required" },
          "429": { "description": "Burst limit reached" },
          "503": { "description": "Retrieval temporarily unavailable" }
        }
      }
    }
  }
}