{
  "openapi": "3.1.0",
  "info": {
    "title": "AgentNet Outcome Execution Network API",
    "version": "2.0.0",
    "description": "AgentNet V1 \u2014 outcome plan/quote/execute/status/result lifecycle, capability catalog, and provider registration. Settlement via x402 USDC on Base (eip155:8453).",
    "contact": {
      "url": "https://agentnet.advalorem.io/"
    }
  },
  "servers": [
    {
      "url": "https://agentic.advalorem.io/api/v1"
    }
  ],
  "paths": {
    "/outcomes/plan": {
      "post": {
        "summary": "Create an outcome plan",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "objective"
                ],
                "properties": {
                  "objective": {
                    "type": "string"
                  },
                  "budget": {
                    "type": "number"
                  },
                  "permissions": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Plan created (plan_id, units, cost_estimate)"
          },
          "401": {
            "description": "Authentication required"
          }
        }
      }
    },
    "/outcomes/plans/{planId}": {
      "get": {
        "summary": "Get plan details",
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Plan with units and status"
          }
        }
      }
    },
    "/outcomes/{planId}/quote": {
      "post": {
        "summary": "Quote a plan (x402 payment required)",
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "quote_id": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Quoted and paid"
          },
          "402": {
            "description": "Payment required (x402)"
          }
        }
      }
    },
    "/outcomes/{planId}/execute": {
      "post": {
        "summary": "Execute a quoted plan",
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Execution started (run_id)"
          },
          "402": {
            "description": "Payment required"
          }
        }
      }
    },
    "/outcomes/{planId}/status": {
      "get": {
        "summary": "Get execution status",
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Status (RUNNING, SUCCEEDED, FAILED, etc.)"
          }
        }
      }
    },
    "/outcomes/{planId}/result": {
      "get": {
        "summary": "Get execution result with evidence",
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result with verified output and evidence"
          }
        }
      }
    },
    "/jobs/{jobId}": {
      "get": {
        "summary": "Get job status by ID",
        "parameters": [
          {
            "name": "jobId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Job status"
          }
        }
      }
    },
    "/jobs/{jobId}/result": {
      "get": {
        "summary": "Get job result by ID",
        "parameters": [
          {
            "name": "jobId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Job result"
          }
        }
      }
    },
    "/capabilities": {
      "get": {
        "summary": "List all capabilities with normalized status",
        "responses": {
          "200": {
            "description": "Capability list with LIVE/PREVIEW/UNAVAILABLE status"
          }
        }
      }
    },
    "/providers/register": {
      "post": {
        "summary": "Register a new provider",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Provider registered"
          }
        }
      }
    },
    "/providers/validate": {
      "post": {
        "summary": "Validate a provider endpoint",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Validation result"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "x402": {
        "type": "apiKey",
        "in": "header",
        "name": "X-PAYMENT"
      }
    }
  },
  "x-agentnet": {
    "settlement_asset": "USDC",
    "network": "eip155:8453",
    "usdc_contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "mcp_endpoint": "https://agentic.advalorem.io/mcp",
    "catalog": "https://agentnet.advalorem.io/agentnet-catalog.json",
    "llms_txt": "https://agentic.advalorem.io/llms.txt",
    "generated_at": "2026-10-18T03:01:18Z"
  }
}