{"openapi":"3.1.0","info":{"title":"VENRAC Public Developer API","version":"0.1.0-prototype.1","summary":"Source-backed public discovery, AI-readiness, and scoped capability invocation API."},"servers":[{"url":"https://venrac.com/v1"}],"paths":{"/openapi.json":{"get":{"operationId":"openApiDocument","responses":{"200":{"description":"OpenAPI 3.1 contract","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/health":{"get":{"operationId":"health","responses":{"200":{"description":"Health","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/sdk":{"get":{"operationId":"sdkFoundation","responses":{"200":{"description":"SdkFoundation","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/ai-readiness":{"get":{"operationId":"aiReadiness","responses":{"200":{"description":"AIReadinessReport","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/capabilities":{"get":{"operationId":"listCapabilities","responses":{"200":{"description":"Capabilities","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/tools":{"get":{"operationId":"toolRegistry","responses":{"200":{"description":"CapabilityRegistryReport","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/security/vault":{"get":{"operationId":"credentialVault","responses":{"200":{"description":"credentialVault","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/policy":{"get":{"operationId":"policyEngine","responses":{"200":{"description":"policyEngine","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/actions/runtime":{"get":{"operationId":"actionRuntime","responses":{"200":{"description":"actionRuntime","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/mcp/gateway/connections":{"get":{"operationId":"listMcpGatewayConnections","parameters":[{"name":"X-Tenant-Id","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Actor-Role","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"MCP gateway connections","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}},"403":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}},"post":{"operationId":"provisionMcpGatewayConnection","parameters":[{"name":"X-Tenant-Id","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Actor-Role","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Actor-Id","in":"header","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["environment","allowedTools","rateLimitPerMinute"],"properties":{"environment":{"type":"string","enum":["dev","sandbox","prod"]},"allowedTools":{"type":"array","minItems":1,"items":{"type":"string"}},"rateLimitPerMinute":{"type":"integer","minimum":1,"maximum":10000}}}}}},"responses":{"201":{"description":"Provisioned MCP gateway connection with one-time token","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}},"403":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"422":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}},"/mcp/gateway/connections/{connectionId}/revoke":{"post":{"operationId":"revokeMcpGatewayConnection","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Tenant-Id","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Actor-Role","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Actor-Id","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Revoked MCP gateway connection","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}},"403":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"422":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}},"/mcp/gateway/audit":{"get":{"operationId":"mcpGatewayAudit","responses":{"200":{"description":"mcpGatewayAudit","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/actions/{runId}":{"get":{"operationId":"getActionRun","parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Tenant-Id","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"ActionRun","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}},"403":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}},"/actions/{runId}/approve":{"post":{"operationId":"approveAndExecuteAction","parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Tenant-Id","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Actor-Role","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Subject-Ref","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-MFA-Verified","in":"header","required":true,"schema":{"type":"string","enum":["true"]}}],"responses":{"200":{"description":"ActionRun","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}},"403":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"422":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}},"/actions/{runId}/reconcile":{"post":{"operationId":"reconcileAction","parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Tenant-Id","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Actor-Role","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"ActionRun","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}},"403":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"422":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}},"/actions/{runId}/compensate":{"post":{"operationId":"compensateAction","parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Tenant-Id","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Actor-Role","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Subject-Ref","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-MFA-Verified","in":"header","required":true,"schema":{"type":"string","enum":["true"]}}],"responses":{"200":{"description":"ActionRun","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}},"403":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}},"/protocols":{"get":{"operationId":"protocolGateway","responses":{"200":{"description":"protocolGateway","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/protocol-bridges":{"get":{"operationId":"protocolBridgeProjection","responses":{"200":{"description":"protocolBridgeProjection","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/observability":{"get":{"operationId":"observability","responses":{"200":{"description":"observability","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/visibility":{"get":{"operationId":"visibilityMonitor","responses":{"200":{"description":"visibilityMonitor","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/optimization":{"get":{"operationId":"optimizationLoop","responses":{"200":{"description":"optimizationLoop","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/pilots":{"get":{"operationId":"referencePilots","responses":{"200":{"description":"referencePilots","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/commercialization":{"get":{"operationId":"commercialization","responses":{"200":{"description":"commercialization","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/scanner":{"get":{"operationId":"publicScanner","responses":{"200":{"description":"publicScanner","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/onboarding":{"get":{"operationId":"onboardingFunnel","responses":{"200":{"description":"onboardingFunnel","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/registry/free":{"get":{"operationId":"freeRegistry","responses":{"200":{"description":"freeRegistry","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/discovery/public":{"get":{"operationId":"publicBusinessDiscovery","responses":{"200":{"description":"publicBusinessDiscovery","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/launchpad/command-center":{"get":{"operationId":"launchpadCommandCenter","responses":{"200":{"description":"launchpadCommandCenter","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/identity/onboarding":{"get":{"operationId":"identityOnboarding","responses":{"200":{"description":"identityOnboarding","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/governance/ux":{"get":{"operationId":"governanceUx","responses":{"200":{"description":"governanceUx","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/connections/manager":{"get":{"operationId":"connectionManager","responses":{"200":{"description":"connectionManager","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/ingestion/platform":{"get":{"operationId":"ingestionPlatform","responses":{"200":{"description":"ingestionPlatform","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/knowledge/platform":{"get":{"operationId":"knowledgePlatform","responses":{"200":{"description":"knowledgePlatform","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/visibility/intelligence":{"get":{"operationId":"visibilityIntelligence","responses":{"200":{"description":"visibilityIntelligence","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/optimization/workbench":{"get":{"operationId":"optimizationWorkbench","responses":{"200":{"description":"optimizationWorkbench","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/connectors/marketplace":{"get":{"operationId":"connectorMarketplace","responses":{"200":{"description":"connectorMarketplace","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/capabilities/evaluation":{"get":{"operationId":"capabilityEvaluation","responses":{"200":{"description":"capabilityEvaluation","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/protocols/evolution":{"get":{"operationId":"protocolEvolution","responses":{"200":{"description":"protocolEvolution","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/actions/governance":{"get":{"operationId":"governanceActionRuntime","responses":{"200":{"description":"governanceActionRuntime","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/capabilities/invoke":{"post":{"operationId":"invokeCapability","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["capabilityName","scopes","payload"],"properties":{"capabilityName":{"type":"string","enum":["business.get","source.list","company.get","product.get","pricing.get","docs.search","integration.list","security.get"]},"scopes":{"type":"array","items":{"type":"string"}},"payload":{"type":"object"}}}}}},"responses":{"200":{"description":"CapabilityInvocation","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"503":{"description":"Problem Details error","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}},"/connectors/runtime":{"get":{"operationId":"connectorRuntimeReport","responses":{"200":{"description":"ConnectorRuntimeReport","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/providers/provider_000001":{"get":{"operationId":"getProvider","responses":{"200":{"description":"PublicDiscoveryProfile","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/providers/provider_000001/sources":{"get":{"operationId":"listProviderSources","responses":{"200":{"description":"SourceList","headers":{"X-Request-Id":{"description":"Request correlation identifier.","schema":{"type":"string"}},"X-Venrac-Api-Version":{"description":"Resolved API contract version.","schema":{"type":"string","enum":["v1"]}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"BusinessGetInput":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"}}},"BusinessGetOutput":{"type":"object","required":["providerId","canonicalName","facts"],"properties":{"providerId":{"type":"string"},"canonicalName":{"type":"string"},"facts":{"type":"array","items":{"type":"object"}}}},"SourceListInput":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"}}},"SourceListOutput":{"type":"object","required":["sources"],"properties":{"sources":{"type":"array","items":{"type":"object"}}}},"CompanyGetInput":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"},"query":{"type":"string"}}},"CompanyGetOutput":{"type":"object","required":["providerId","result"],"properties":{"providerId":{"type":"string"},"result":{"type":"object"}}},"ProductGetInput":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"},"query":{"type":"string"}}},"ProductGetOutput":{"type":"object","required":["providerId","result"],"properties":{"providerId":{"type":"string"},"result":{"type":"object"}}},"PricingGetInput":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"},"query":{"type":"string"}}},"PricingGetOutput":{"type":"object","required":["providerId","result"],"properties":{"providerId":{"type":"string"},"result":{"type":"object"}}},"DocsSearchInput":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"},"query":{"type":"string"}}},"DocsSearchOutput":{"type":"object","required":["providerId","result"],"properties":{"providerId":{"type":"string"},"result":{"type":"object"}}},"IntegrationListInput":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"},"query":{"type":"string"}}},"IntegrationListOutput":{"type":"object","required":["providerId","result"],"properties":{"providerId":{"type":"string"},"result":{"type":"object"}}},"SecurityGetInput":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"},"query":{"type":"string"}}},"SecurityGetOutput":{"type":"object","required":["providerId","result"],"properties":{"providerId":{"type":"string"},"result":{"type":"object"}}},"ProblemDetails":{"type":"object","additionalProperties":false,"required":["type","title","status","detail","instance","code","requestId"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string","minLength":1},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string","minLength":1},"instance":{"type":"string","minLength":1},"code":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"},"requestId":{"type":"string","minLength":1,"maxLength":128}}}},"securitySchemes":{"scopedPublicRead":{"type":"http","scheme":"bearer","bearerFormat":"VENRAC installation token","description":"Optional for public reads and required when a provider policy demands a scoped installation token."}}},"x-venrac-contract":{"schemaVersion":"0.1.0-prototype.1","aiReadinessScore":"100/100","sdkKits":["typescript-client","nextjs-middleware","wordpress-plugin","rest-contract"],"problemDetailsContentType":"application/problem+json","idempotencyHeader":"Idempotency-Key","telemetryHeaders":["X-Request-Id","X-Venrac-Client","X-Venrac-SDK-Version"],"capabilityContractSource":"capability_registry","capabilitySemanticParity":true,"capabilitySemanticHashes":{"business.get":"36d81f6f449638bff4ef9b7d6dd418698c8a309168229807f4151da9a91ae564","company.get":"64f1ed9bc9288937bd7432dae90e8af2dabc584f4bb32d53f5bf2fefa80cd589","docs.search":"df9d35124dbee1a64da6aa5a37935fc96d8a6c8ae28fc147c4f5f11659b110d3","integration.list":"680f5305a558dd6451a28b823564f05534a3d9ec4d24d6f46e06ee8707856e59","pricing.get":"6919546514086fbed266f61301163e6ea697eee24d079053a70a950fde2f4a5c","product.get":"c6a844a43c78462e78165084d620c8e5bb6d0e34f479b6edb338f0f3ffaabb48","security.get":"cc36773e97e16102f2107c692efba538ba08cb167c2c8d23288015aff153f0dc","source.list":"b3eb5a14169edb4ddf5630ffb1c224ceea72511d211bd0854abb565abcc28abb"},"capabilityOperations":[{"capabilityName":"business.get","version":"0.1.0-prototype.1","risk":"read","exposureScope":"public","requiredScopes":["public:business.read"],"inputSchema":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"}}},"outputSchema":{"type":"object","required":["providerId","canonicalName","facts"],"properties":{"providerId":{"type":"string"},"canonicalName":{"type":"string"},"facts":{"type":"array","items":{"type":"object"}}}},"errorCodes":["schema_validation_failed","provider_id_mismatch","capability_denied"],"semanticHash":"36d81f6f449638bff4ef9b7d6dd418698c8a309168229807f4151da9a91ae564","operationId":"businessGet","method":"POST","path":"/capabilities/invoke"},{"capabilityName":"company.get","version":"0.1.0-prototype.1","risk":"read","exposureScope":"public","requiredScopes":["public:company.read"],"inputSchema":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"},"query":{"type":"string"}}},"outputSchema":{"type":"object","required":["providerId","result"],"properties":{"providerId":{"type":"string"},"result":{"type":"object"}}},"errorCodes":["schema_validation_failed","provider_id_mismatch","capability_denied","not_found"],"semanticHash":"64f1ed9bc9288937bd7432dae90e8af2dabc584f4bb32d53f5bf2fefa80cd589","operationId":"companyGet","method":"POST","path":"/capabilities/invoke"},{"capabilityName":"docs.search","version":"0.1.0-prototype.1","risk":"read","exposureScope":"public","requiredScopes":["public:docs.read"],"inputSchema":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"},"query":{"type":"string"}}},"outputSchema":{"type":"object","required":["providerId","result"],"properties":{"providerId":{"type":"string"},"result":{"type":"object"}}},"errorCodes":["schema_validation_failed","provider_id_mismatch","capability_denied","not_found"],"semanticHash":"df9d35124dbee1a64da6aa5a37935fc96d8a6c8ae28fc147c4f5f11659b110d3","operationId":"docsSearch","method":"POST","path":"/capabilities/invoke"},{"capabilityName":"integration.list","version":"0.1.0-prototype.1","risk":"read","exposureScope":"public","requiredScopes":["public:integration.read"],"inputSchema":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"},"query":{"type":"string"}}},"outputSchema":{"type":"object","required":["providerId","result"],"properties":{"providerId":{"type":"string"},"result":{"type":"object"}}},"errorCodes":["schema_validation_failed","provider_id_mismatch","capability_denied","not_found"],"semanticHash":"680f5305a558dd6451a28b823564f05534a3d9ec4d24d6f46e06ee8707856e59","operationId":"integrationList","method":"POST","path":"/capabilities/invoke"},{"capabilityName":"pricing.get","version":"0.1.0-prototype.1","risk":"read","exposureScope":"public","requiredScopes":["public:pricing.read"],"inputSchema":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"},"query":{"type":"string"}}},"outputSchema":{"type":"object","required":["providerId","result"],"properties":{"providerId":{"type":"string"},"result":{"type":"object"}}},"errorCodes":["schema_validation_failed","provider_id_mismatch","capability_denied","not_found"],"semanticHash":"6919546514086fbed266f61301163e6ea697eee24d079053a70a950fde2f4a5c","operationId":"pricingGet","method":"POST","path":"/capabilities/invoke"},{"capabilityName":"product.get","version":"0.1.0-prototype.1","risk":"read","exposureScope":"public","requiredScopes":["public:product.read"],"inputSchema":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"},"query":{"type":"string"}}},"outputSchema":{"type":"object","required":["providerId","result"],"properties":{"providerId":{"type":"string"},"result":{"type":"object"}}},"errorCodes":["schema_validation_failed","provider_id_mismatch","capability_denied","not_found"],"semanticHash":"c6a844a43c78462e78165084d620c8e5bb6d0e34f479b6edb338f0f3ffaabb48","operationId":"productGet","method":"POST","path":"/capabilities/invoke"},{"capabilityName":"security.get","version":"0.1.0-prototype.1","risk":"read","exposureScope":"public","requiredScopes":["public:security.read"],"inputSchema":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"},"query":{"type":"string"}}},"outputSchema":{"type":"object","required":["providerId","result"],"properties":{"providerId":{"type":"string"},"result":{"type":"object"}}},"errorCodes":["schema_validation_failed","provider_id_mismatch","capability_denied","not_found"],"semanticHash":"cc36773e97e16102f2107c692efba538ba08cb167c2c8d23288015aff153f0dc","operationId":"securityGet","method":"POST","path":"/capabilities/invoke"},{"capabilityName":"source.list","version":"0.1.0-prototype.1","risk":"read","exposureScope":"public","requiredScopes":["public:source.read"],"inputSchema":{"type":"object","required":["providerId"],"properties":{"providerId":{"type":"string"}}},"outputSchema":{"type":"object","required":["sources"],"properties":{"sources":{"type":"array","items":{"type":"object"}}}},"errorCodes":["schema_validation_failed","provider_id_mismatch","capability_denied"],"semanticHash":"b3eb5a14169edb4ddf5630ffb1c224ceea72511d211bd0854abb565abcc28abb","operationId":"sourceList","method":"POST","path":"/capabilities/invoke"}],"mcpEndpoint":"https://venrac.com/mcp","a2aAgentCardEndpoint":"https://venrac.com/.well-known/agent-card.json"}}