{"openapi":"3.1.0","info":{"title":"MC-1 Intelligence Control Plane API","version":"1.0.0","description":"Canonical documented public HTTP contract maintained in the versioned MC-1 contract registry and conformance-tested against implemented runtime routes. Endpoint availability remains subject to authentication, entitlements, feature flags, and policy."},"servers":[{"url":"https://api.colomboai.com/v1"}],"paths":{"/responses":{"post":{"operationId":"post_responses","summary":"Response object or event stream with route attribution","description":"OpenAI-compatible input, optional model, streaming, and optional MC-1 controls","tags":["responses"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"OpenAI-compatible input, optional model, streaming, and optional MC-1 controls","required":["input"],"properties":{"model":{"type":"string"},"input":{"description":"Text or structured OpenAI-compatible input."},"stream":{"type":"boolean"},"mc1":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"responses":{"200":{"description":"Response object or event stream with route attribution","content":{"application/json":{"schema":{"type":"object","description":"Response object or event stream with route attribution","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}},"text/event-stream":{"schema":{"type":"string","description":"Server-sent event stream."}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project inference","x-implementation-source":"app/v1/responses/route.ts"}},"/chat/completions":{"post":{"operationId":"post_chat_completions","summary":"Chat completion or SSE stream with usage","description":"OpenAI-compatible messages, tools, streaming, provider, and MC-1 controls","tags":["chat"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"OpenAI-compatible messages, tools, streaming, provider, and MC-1 controls","required":["model","messages"],"properties":{"model":{"type":"string"},"messages":{"type":"array","items":{"type":"object","additionalProperties":true}},"tools":{"type":"array","items":{"type":"object","additionalProperties":true}},"stream":{"type":"boolean"},"provider":{"type":"object","additionalProperties":true},"mc1":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"responses":{"200":{"description":"Chat completion or SSE stream with usage","content":{"application/json":{"schema":{"type":"object","description":"Chat completion or SSE stream with usage","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}},"text/event-stream":{"schema":{"type":"string","description":"Server-sent event stream."}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project inference","x-implementation-source":"app/v1/chat/completions/route.ts"}},"/models":{"get":{"operationId":"get_models","summary":"Configured model collection","description":"No body","tags":["models"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Configured model collection","content":{"application/json":{"schema":{"type":"object","description":"Configured model collection","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project catalog","x-implementation-source":"app/v1/models/route.ts"}},"/models/capabilities":{"get":{"operationId":"get_models_capabilities","summary":"Capability-enriched model collection","description":"No body","tags":["models"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Capability-enriched model collection","content":{"application/json":{"schema":{"type":"object","description":"Capability-enriched model collection","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project catalog","x-implementation-source":"app/v1/models/capabilities/route.ts"}},"/intelligence/execute":{"post":{"operationId":"post_intelligence_execute","summary":"Execution plan, output, evaluation, and route evidence","description":"Task, objective, risk, constraints, evaluation, escalation, identity, and stream","tags":["intelligence"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Task, objective, risk, constraints, evaluation, escalation, identity, and stream","required":["task"],"properties":{"task":{"type":"object","additionalProperties":true},"objective":{"type":"string"},"risk":{"type":"string"},"constraints":{"type":"object","additionalProperties":true},"evaluation":{"type":"object","additionalProperties":true},"escalation":{"type":"object","additionalProperties":true},"agent_identity":{"type":"string"},"stream":{"type":"boolean"}},"additionalProperties":true}}}},"responses":{"200":{"description":"Execution plan, output, evaluation, and route evidence","content":{"application/json":{"schema":{"type":"object","description":"Execution plan, output, evaluation, and route evidence","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}},"text/event-stream":{"schema":{"type":"string","description":"Server-sent event stream."}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project intelligence","x-implementation-source":"app/v1/intelligence/execute/route.ts"}},"/routes/{routeId}":{"get":{"operationId":"get_routes_routeId","summary":"Route, plan, evaluation, Guard, usage, and trace evidence","description":"Path routeId","tags":["routes"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"routeId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Route, plan, evaluation, Guard, usage, and trace evidence","content":{"application/json":{"schema":{"type":"object","description":"Route, plan, evaluation, Guard, usage, and trace evidence","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Owning project route","x-implementation-source":"app/v1/routes/[routeId]/route.ts"}},"/routing":{"get":{"operationId":"get_routing","summary":"Measured routing summary","description":"No body","tags":["routing"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Measured routing summary","content":{"application/json":{"schema":{"type":"object","description":"Measured routing summary","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project analytics","x-implementation-source":"app/v1/routing/route.ts"}},"/activity":{"get":{"operationId":"get_activity","summary":"Content-minimized route activity","description":"Bounded limit query parameter","tags":["activity"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"limit","description":"Maximum activity records, clamped by the runtime to 1–500.","schema":{"type":"integer"},"in":"query","required":false}],"responses":{"200":{"description":"Content-minimized route activity","content":{"application/json":{"schema":{"type":"object","description":"Content-minimized route activity","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project analytics","x-implementation-source":"app/v1/activity/route.ts"}},"/usage":{"get":{"operationId":"get_usage","summary":"Tenant-scoped usage ledger aggregation for the authenticated project","description":"No body","tags":["usage"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Tenant-scoped usage ledger aggregation for the authenticated project","content":{"application/json":{"schema":{"type":"object","description":"Tenant-scoped usage ledger aggregation for the authenticated project","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project finance","x-implementation-source":"app/v1/usage/route.ts"}},"/pricing":{"get":{"operationId":"get_pricing","summary":"Authoritative pricing catalog","description":"No body","tags":["pricing"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Authoritative pricing catalog","content":{"application/json":{"schema":{"type":"object","description":"Authoritative pricing catalog","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Authenticated catalog","x-implementation-source":"app/v1/pricing/route.ts"}},"/billing":{"get":{"operationId":"get_billing","summary":"Billing and ledger summary","description":"No body","tags":["billing"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Billing and ledger summary","content":{"application/json":{"schema":{"type":"object","description":"Billing and ledger summary","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project billing","x-implementation-source":"app/v1/billing/route.ts"}},"/billing/balance":{"get":{"operationId":"get_billing_balance","summary":"Prepaid balance and liability facts","description":"No body","tags":["billing"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Prepaid balance and liability facts","content":{"application/json":{"schema":{"type":"object","description":"Prepaid balance and liability facts","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project billing","x-implementation-source":"app/v1/billing/balance/route.ts"}},"/billing/checkout":{"post":{"operationId":"post_billing_checkout","summary":"Configured Stripe Checkout result","description":"Purchase amount and idempotency context","tags":["billing"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Purchase amount and idempotency context","required":["mode","email"],"properties":{"mode":{"type":"string"},"email":{"type":"string"},"amount_usd":{"type":"number"}},"additionalProperties":true}}}},"responses":{"200":{"description":"Configured Stripe Checkout result","content":{"application/json":{"schema":{"type":"object","description":"Configured Stripe Checkout result","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project billing admin","x-implementation-source":"app/v1/billing/checkout/route.ts"}},"/policies":{"get":{"operationId":"get_policies","summary":"Scoped policy versions","description":"No body","tags":["policies"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Scoped policy versions","content":{"application/json":{"schema":{"type":"object","description":"Scoped policy versions","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project policy","x-implementation-source":"app/v1/policies/route.ts"},"post":{"operationId":"post_policies","summary":"Persisted policy version","description":"Versioned normalized policy","tags":["policies"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Versioned normalized policy","required":["name"],"properties":{"name":{"type":"string"},"rules":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"responses":{"201":{"description":"Persisted policy version","content":{"application/json":{"schema":{"type":"object","description":"Persisted policy version","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project policy admin","x-implementation-source":"app/v1/policies/route.ts"}},"/policies/test":{"post":{"operationId":"post_policies_test","summary":"Eligibility decision and eligible paths","description":"Candidate request and policy context","tags":["policies"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Candidate request and policy context","required":["prompt"],"properties":{"prompt":{"type":"string"},"objective":{"type":"string"},"max_cost_usd":{"type":"number"},"max_latency_ms":{"type":"number"}},"additionalProperties":true}}}},"responses":{"200":{"description":"Eligibility decision and eligible paths","content":{"application/json":{"schema":{"type":"object","description":"Eligibility decision and eligible paths","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project policy","x-implementation-source":"app/v1/policies/test/route.ts"}},"/providers":{"get":{"operationId":"get_providers","summary":"Configured provider collection","description":"No body","tags":["providers"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Configured provider collection","content":{"application/json":{"schema":{"type":"object","description":"Configured provider collection","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project catalog","x-implementation-source":"app/v1/providers/route.ts"}},"/providers/health":{"get":{"operationId":"get_providers_health","summary":"Observed provider readiness and health","description":"No body","tags":["providers"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Observed provider readiness and health","content":{"application/json":{"schema":{"type":"object","description":"Observed provider readiness and health","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project operations","x-implementation-source":"app/v1/providers/health/route.ts"}},"/benchmarks":{"get":{"operationId":"get_benchmarks","summary":"Measured evaluated-route aggregates","description":"No body","tags":["benchmarks"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Measured evaluated-route aggregates","content":{"application/json":{"schema":{"type":"object","description":"Measured evaluated-route aggregates","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project evaluation","x-implementation-source":"app/v1/benchmarks/route.ts"}},"/api-keys":{"get":{"operationId":"get_api_keys","summary":"Redacted scoped key metadata","description":"No body","tags":["api-keys"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Redacted scoped key metadata","content":{"application/json":{"schema":{"type":"object","description":"Redacted scoped key metadata","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project admin","x-implementation-source":"app/v1/api-keys/route.ts"},"post":{"operationId":"post_api_keys","summary":"One-time secret plus key metadata","description":"Optional key name and bounded permissions","tags":["api-keys"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Optional key name and bounded permissions","required":[],"properties":{"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}},"responses":{"201":{"description":"One-time secret plus key metadata","content":{"application/json":{"schema":{"type":"object","description":"One-time secret plus key metadata","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project admin","x-implementation-source":"app/v1/api-keys/route.ts"}},"/byok":{"get":{"operationId":"get_byok","summary":"Redacted customer-compute connections","description":"No body","tags":["byok"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Redacted customer-compute connections","content":{"application/json":{"schema":{"type":"object","description":"Redacted customer-compute connections","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project admin","x-implementation-source":"app/v1/byok/route.ts"},"post":{"operationId":"post_byok","summary":"Registered connection metadata","description":"HTTPS endpoint and server-side secret reference","tags":["byok"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"HTTPS endpoint and server-side secret reference","required":["name","endpoint","secret_ref"],"properties":{"name":{"type":"string"},"endpoint":{"type":"string"},"secret_ref":{"type":"string"},"region":{"type":"string"}},"additionalProperties":true}}}},"responses":{"201":{"description":"Registered connection metadata","content":{"application/json":{"schema":{"type":"object","description":"Registered connection metadata","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project admin","x-implementation-source":"app/v1/byok/route.ts"}},"/audit":{"get":{"operationId":"get_audit","summary":"Tamper-evident audit events","description":"No body","tags":["audit"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Tamper-evident audit events","content":{"application/json":{"schema":{"type":"object","description":"Tamper-evident audit events","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project security","x-implementation-source":"app/v1/audit/route.ts"}},"/forward/overview":{"get":{"operationId":"get_forward_overview","summary":"Entitlement and discovery overview","description":"No body","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Entitlement and discovery overview","content":{"application/json":{"schema":{"type":"object","description":"Entitlement and discovery overview","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Forward project","x-implementation-source":"app/v1/forward/overview/route.ts"}},"/forward/connectors":{"get":{"operationId":"get_forward_connectors","summary":"Tenant-scoped connector inventory","description":"No body","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Tenant-scoped connector inventory","content":{"application/json":{"schema":{"type":"object","description":"Tenant-scoped connector inventory","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Forward project","x-implementation-source":"app/v1/forward/connectors/route.ts"}},"/forward/discovery":{"get":{"operationId":"get_forward_discovery","summary":"Read-only discovery evidence","description":"No body","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Read-only discovery evidence","content":{"application/json":{"schema":{"type":"object","description":"Read-only discovery evidence","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Forward project","x-implementation-source":"app/v1/forward/discovery/route.ts"},"post":{"operationId":"post_forward_discovery","summary":"Pending read-only discovery run","description":"Read-only discovery name and optional configured connector references","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Read-only discovery name and optional configured connector references","required":["name"],"properties":{"name":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}},"connection_mode":{"type":"string","enum":["READ_ONLY"]}},"additionalProperties":true}}}},"responses":{"201":{"description":"Pending read-only discovery run","content":{"application/json":{"schema":{"type":"object","description":"Pending read-only discovery run","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Forward project admin","x-implementation-source":"app/v1/forward/discovery/route.ts"}},"/forward/graph":{"get":{"operationId":"get_forward_graph","summary":"Provenance-aware graph projection","description":"No body","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Provenance-aware graph projection","content":{"application/json":{"schema":{"type":"object","description":"Provenance-aware graph projection","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Forward project","x-implementation-source":"app/v1/forward/graph/route.ts"}},"/forward/opportunities":{"get":{"operationId":"get_forward_opportunities","summary":"Scored opportunity evidence","description":"No body","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Scored opportunity evidence","content":{"application/json":{"schema":{"type":"object","description":"Scored opportunity evidence","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Forward project","x-implementation-source":"app/v1/forward/opportunities/route.ts"}},"/forward/opportunities/{opportunityId}/review":{"post":{"operationId":"post_forward_opportunities_opportunityId_review","summary":"Reviewed opportunity evidence","description":"Non-production review status and rationale","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"opportunityId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Non-production review status and rationale","required":["status","reason"],"properties":{"status":{"type":"string","description":"Only non-production review transitions are public.","enum":["INVESTIGATING","REJECTED"]},"reason":{"type":"string","description":"Review rationale between 10 and 1,000 characters."}},"additionalProperties":true}}}},"responses":{"200":{"description":"Reviewed opportunity evidence","content":{"application/json":{"schema":{"type":"object","description":"Reviewed opportunity evidence","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Forward project admin","x-implementation-source":"app/v1/forward/opportunities/[opportunityId]/review/route.ts"}},"/advanced/capabilities":{"get":{"operationId":"get_advanced_capabilities","summary":"Configured and connected runtime capability state","description":"No body","tags":["advanced"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Configured and connected runtime capability state","content":{"application/json":{"schema":{"type":"object","description":"Configured and connected runtime capability state","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project runtime","x-implementation-source":"app/v1/advanced/capabilities/route.ts"}},"/advanced/execute":{"post":{"operationId":"post_advanced_execute","summary":"Durable external-runtime execution state","description":"Mode, bounded task, identity, and idempotency key","tags":["advanced"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Mode, bounded task, identity, and idempotency key","required":["mode","input"],"properties":{"mode":{"type":"string"},"input":{"description":"Arbitrary bounded JSON input accepted by the selected runtime."},"constraints":{"type":"object","additionalProperties":true},"agent_identity":{"type":"string"}},"additionalProperties":true}}}},"responses":{"200":{"description":"Durable external-runtime execution state","content":{"application/json":{"schema":{"type":"object","description":"Durable external-runtime execution state","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"202":{"description":"Durable external-runtime execution state","content":{"application/json":{"schema":{"type":"object","description":"Durable external-runtime execution state","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project runtime admin","x-implementation-source":"app/v1/advanced/execute/route.ts"}},"/training/jobs":{"get":{"operationId":"get_training_jobs","summary":"Authorized training jobs","description":"No body","tags":["training"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Authorized training jobs","content":{"application/json":{"schema":{"type":"object","description":"Authorized training jobs","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project ML","x-implementation-source":"app/v1/training/jobs/route.ts"},"post":{"operationId":"post_training_jobs","summary":"Reserved and submitted training job","description":"Authorized dataset, provider, method, tokens, and maximum cost","tags":["training"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Authorized dataset, provider, method, tokens, and maximum cost","required":["dataset_id","provider_id","base_model","method","training_tokens","max_cost_usd"],"properties":{"dataset_id":{"type":"string"},"provider_id":{"type":"string"},"base_model":{"type":"string"},"method":{"type":"string"},"training_tokens":{"type":"integer"},"max_cost_usd":{"type":"number"},"configuration":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"responses":{"201":{"description":"Reserved and submitted training job","content":{"application/json":{"schema":{"type":"object","description":"Reserved and submitted training job","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project ML admin","x-implementation-source":"app/v1/training/jobs/route.ts"}},"/specialized-models":{"get":{"operationId":"get_specialized_models","summary":"Specialized model lineage","description":"No body","tags":["specialized-models"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Specialized model lineage","content":{"application/json":{"schema":{"type":"object","description":"Specialized model lineage","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Project ML","x-implementation-source":"app/v1/specialized-models/route.ts"}},"/team":{"get":{"operationId":"get_team","summary":"Members, roles, and invitations","description":"No body","tags":["team"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Members, roles, and invitations","content":{"application/json":{"schema":{"type":"object","description":"Members, roles, and invitations","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Organization admin","x-implementation-source":"app/v1/team/route.ts"}},"/support/requests":{"post":{"operationId":"post_support_requests","summary":"Support reference and delivery status","description":"Category, priority, subject, and bounded details","tags":["support"],"security":[{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Category, priority, subject, and bounded details","required":["category","priority","subject","message"],"properties":{"category":{"type":"string","enum":["technical","billing","account","security","product","other"]},"priority":{"type":"string","enum":["normal","high","urgent"]},"subject":{"type":"string"},"message":{"type":"string"},"page_path":{"type":"string"}},"additionalProperties":true}}}},"responses":{"201":{"description":"Support reference and delivery status","content":{"application/json":{"schema":{"type":"object","description":"Support reference and delivery status","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-mc1-scope":"Signed-in project","x-implementation-source":"app/v1/support/requests/route.ts"}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"MC-1 project API key."},"siteSession":{"type":"apiKey","in":"cookie","name":"mc1_session","description":"Verified MC-1 site identity session. The deployed cookie name may be environment-specific."}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"responses":{"BadRequest":{"description":"Invalid request"},"Unauthorized":{"description":"Authentication required"},"Forbidden":{"description":"Insufficient authority or policy denial"},"RateLimited":{"description":"Rate boundary reached"}}}}