{"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/C3R 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/C3R controls","required":["input"],"properties":{"model":{"type":"string"},"input":{"description":"Text or structured OpenAI-compatible input."},"max_output_tokens":{"type":"integer","description":"Maximum generated tokens. The logical MC-1 model accepts at most 128,000 and defaults to 4,096; routing admits only executable model profiles that support the requested budget, while exact models use their own validated limit."},"stream":{"type":"boolean"},"provider":{"type":"object","additionalProperties":false,"description":"Eligibility restrictions and provider selection. order and weights are mutually exclusive. weights restrict all attempts to their listed providers, with one relative-weight draw per provider per execution plan; policy and financial filters still apply.","properties":{"only":{"type":"array","items":{"type":"string"}},"order":{"type":"array","items":{"type":"string"}},"weights":{"type":"object","description":"Provider IDs mapped to positive relative weights. Cannot be combined with order; every weighted ID must be in only when a nonempty only list is supplied.","minProperties":1,"maxProperties":500,"additionalProperties":{"type":"number","exclusiveMinimum":0,"maximum":1000000}},"allow_fallbacks":{"type":"boolean"}}},"mc1":{"type":"object","additionalProperties":true,"properties":{"objective":{"type":"string","description":"highest_throughput requires MC1_MEASURED_ROUTING_ENABLED and at least 20 valid streaming observations within 15 minutes per eligible endpoint. Missing evidence returns 503. Provider preferences and all admission controls still apply.","enum":["auto","balanced","best_quality","lowest_cost","lowest_latency","highest_throughput","private","sovereign","agent_safe","high_reliability","local_only"]},"min_output_tokens_per_second":{"type":"number","description":"Require each eligible text route to have a fresh measured median output rate at or above this value. Requires MC1_MEASURED_ROUTING_ENABLED and 20 valid streaming observations in 15 minutes; missing or insufficient evidence returns 503.","exclusiveMinimum":0,"maximum":1000000},"allow_escalation":{"type":"boolean","description":"Explicitly permit the request to cross from customer capacity to policy-approved managed capacity."},"capacity_preference":{"type":"string","description":"Choose customer BYOK capacity first or managed capacity first. Managed-first remains subject to external-egress policy.","enum":["byok_first","managed_first"]},"allow_shared_capacity_fallback":{"type":"boolean","description":"Set false to prevent a BYOK-first request from falling back to shared managed capacity."}}},"c3r":{"type":"object","additionalProperties":false,"description":"Evidence-gated C3R shadow controls. MC-1 retains native routing and commit authority.","properties":{"enabled":{"type":"boolean"},"mode":{"type":"string","enum":["auto","system_one","deliberative","off"]},"system_one":{"type":"boolean"},"objective":{"type":"string","enum":["auto","balanced","best_quality","lowest_cost","lowest_latency","highest_throughput","private","sovereign","agent_safe","high_reliability","local_only"]},"max_cost_usd":{"type":"number","exclusiveMinimum":0},"latency_target_ms":{"type":"number","exclusiveMinimum":0},"require_verification":{"type":"boolean"}}}},"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/C3R 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/C3R controls","required":["model","messages"],"properties":{"model":{"type":"string"},"messages":{"type":"array","items":{"type":"object","additionalProperties":true}},"tools":{"type":"array","items":{"type":"object","additionalProperties":true}},"max_tokens":{"type":"integer","description":"Maximum generated tokens. The logical MC-1 model accepts at most 128,000 and defaults to 4,096; routing admits only executable model profiles that support the requested budget, while exact models use their own validated limit."},"max_completion_tokens":{"type":"integer","description":"Alias for max_tokens. Maximum generated tokens. The logical MC-1 model accepts at most 128,000 and defaults to 4,096; routing admits only executable model profiles that support the requested budget, while exact models use their own validated limit."},"stream":{"type":"boolean"},"provider":{"type":"object","additionalProperties":false,"description":"Eligibility restrictions and provider selection. order and weights are mutually exclusive. weights restrict all attempts to their listed providers, with one relative-weight draw per provider per execution plan; policy and financial filters still apply.","properties":{"only":{"type":"array","items":{"type":"string"}},"order":{"type":"array","items":{"type":"string"}},"weights":{"type":"object","description":"Provider IDs mapped to positive relative weights. Cannot be combined with order; every weighted ID must be in only when a nonempty only list is supplied.","minProperties":1,"maxProperties":500,"additionalProperties":{"type":"number","exclusiveMinimum":0,"maximum":1000000}},"allow_fallbacks":{"type":"boolean"}}},"mc1":{"type":"object","additionalProperties":true,"properties":{"objective":{"type":"string","description":"highest_throughput requires MC1_MEASURED_ROUTING_ENABLED and at least 20 valid streaming observations within 15 minutes per eligible endpoint. Missing evidence returns 503. Provider preferences and all admission controls still apply.","enum":["auto","balanced","best_quality","lowest_cost","lowest_latency","highest_throughput","private","sovereign","agent_safe","high_reliability","local_only"]},"min_output_tokens_per_second":{"type":"number","description":"Require each eligible text route to have a fresh measured median output rate at or above this value. Requires MC1_MEASURED_ROUTING_ENABLED and 20 valid streaming observations in 15 minutes; missing or insufficient evidence returns 503.","exclusiveMinimum":0,"maximum":1000000},"allow_escalation":{"type":"boolean","description":"Explicitly permit the request to cross from customer capacity to policy-approved managed capacity."},"capacity_preference":{"type":"string","description":"Choose customer BYOK capacity first or managed capacity first. Managed-first remains subject to external-egress policy.","enum":["byok_first","managed_first"]},"allow_shared_capacity_fallback":{"type":"boolean","description":"Set false to prevent a BYOK-first request from falling back to shared managed capacity."}}},"c3r":{"type":"object","additionalProperties":false,"description":"Evidence-gated C3R shadow controls. MC-1 retains native routing and commit authority.","properties":{"enabled":{"type":"boolean"},"mode":{"type":"string","enum":["auto","system_one","deliberative","off"]},"system_one":{"type":"boolean"},"objective":{"type":"string","enum":["auto","balanced","best_quality","lowest_cost","lowest_latency","highest_throughput","private","sovereign","agent_safe","high_reliability","local_only"]},"max_cost_usd":{"type":"number","exclusiveMinimum":0},"latency_target_ms":{"type":"number","exclusiveMinimum":0},"require_verification":{"type":"boolean"}}}},"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"}},"/batches":{"post":{"operationId":"post_batches","summary":"Per-item synchronous results or a persisted asynchronous batch object","description":"Legacy bounded synchronous orchestration, or an upstream asynchronous Files + Batches submission to an explicitly batch-capable customer-managed provider","tags":["batches"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Legacy bounded synchronous orchestration, or an upstream asynchronous Files + Batches submission to an explicitly batch-capable customer-managed provider","required":["requests"],"properties":{"mode":{"type":"string","description":"Set to upstream_async for provider-side execution"},"provider_id":{"type":"string","description":"Required with upstream_async"},"endpoint":{"type":"string","description":"Provider batch endpoint"},"completion_window":{"type":"string","description":"Currently 24h"},"requests":{"type":"array","items":{"type":"object","description":"Each item contains unique custom_id and a non-streaming request body.","additionalProperties":true}},"metadata":{"type":"object","description":"Provider batch metadata","additionalProperties":true},"mc1":{"type":"object","additionalProperties":true,"properties":{"objective":{"type":"string","description":"highest_throughput requires MC1_MEASURED_ROUTING_ENABLED and at least 20 valid streaming observations within 15 minutes per eligible endpoint. Missing evidence returns 503. Provider preferences and all admission controls still apply.","enum":["auto","balanced","best_quality","lowest_cost","lowest_latency","highest_throughput","private","sovereign","agent_safe","high_reliability","local_only"]},"min_output_tokens_per_second":{"type":"number","description":"Require each eligible text route to have a fresh measured median output rate at or above this value. Requires MC1_MEASURED_ROUTING_ENABLED and 20 valid streaming observations in 15 minutes; missing or insufficient evidence returns 503.","exclusiveMinimum":0,"maximum":1000000},"allow_escalation":{"type":"boolean","description":"Explicitly permit the request to cross from customer capacity to policy-approved managed capacity."},"capacity_preference":{"type":"string","description":"Choose customer BYOK capacity first or managed capacity first. Managed-first remains subject to external-egress policy.","enum":["byok_first","managed_first"]},"allow_shared_capacity_fallback":{"type":"boolean","description":"Set false to prevent a BYOK-first request from falling back to shared managed capacity."}}}},"additionalProperties":true}}}},"responses":{"200":{"description":"Per-item synchronous results or a persisted asynchronous batch object","content":{"application/json":{"schema":{"type":"object","description":"Per-item synchronous results or a persisted asynchronous batch object","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 inference","x-implementation-source":"app/v1/batches/route.ts"},"get":{"operationId":"get_batches","summary":"Up to 100 tenant-scoped asynchronous provider batch objects","description":"No body","tags":["batches"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Up to 100 tenant-scoped asynchronous provider batch objects","content":{"application/json":{"schema":{"type":"object","description":"Up to 100 tenant-scoped asynchronous provider batch objects","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 inference","x-implementation-source":"app/v1/batches/route.ts"}},"/batches/{batchId}":{"get":{"operationId":"get_batches_batchId","summary":"Persisted batch object with refreshed provider status","description":"No body; batchId is an exact tenant-scoped path parameter","tags":["batches"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"batchId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Persisted batch object with refreshed provider status","content":{"application/json":{"schema":{"type":"object","description":"Persisted batch object with refreshed provider 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":"Project inference","x-implementation-source":"app/v1/batches/[batchId]/route.ts"}},"/batches/{batchId}/cancel":{"post":{"operationId":"post_batches_batchId_cancel","summary":"Updated persisted batch object","description":"No body; batchId is an exact tenant-scoped path parameter","tags":["batches"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"batchId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated persisted batch object","content":{"application/json":{"schema":{"type":"object","description":"Updated persisted batch object","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 inference","x-implementation-source":"app/v1/batches/[batchId]/cancel/route.ts"}},"/batches/{batchId}/output":{"get":{"operationId":"get_batches_batchId_output","summary":"Successful or error JSONL output stream for a completed batch","description":"No body; batchId is an exact tenant-scoped path parameter","tags":["batches"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"batchId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful or error JSONL output stream for a completed batch","content":{"application/json":{"schema":{"type":"object","description":"Successful or error JSONL output stream for a completed batch","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 inference","x-implementation-source":"app/v1/batches/[batchId]/output/route.ts"}},"/rerank":{"post":{"operationId":"post_rerank","summary":"Provider rerank response with MC-1 route and billing attribution","description":"OpenAI-compatible configured rerank payload with model mc-1 or colomboai/mc-1","tags":["rerank"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"OpenAI-compatible configured rerank payload with model mc-1 or colomboai/mc-1","required":["model","query","documents"],"properties":{"model":{"type":"string"},"query":{"type":"string"},"documents":{"type":"array","items":{"type":"string"}},"mc1":{"type":"object","additionalProperties":true,"properties":{"objective":{"type":"string","description":"highest_throughput requires MC1_MEASURED_ROUTING_ENABLED and at least 20 valid streaming observations within 15 minutes per eligible endpoint. Missing evidence returns 503. Provider preferences and all admission controls still apply.","enum":["auto","balanced","best_quality","lowest_cost","lowest_latency","highest_throughput","private","sovereign","agent_safe","high_reliability","local_only"]},"min_output_tokens_per_second":{"type":"number","description":"Require each eligible text route to have a fresh measured median output rate at or above this value. Requires MC1_MEASURED_ROUTING_ENABLED and 20 valid streaming observations in 15 minutes; missing or insufficient evidence returns 503.","exclusiveMinimum":0,"maximum":1000000},"allow_escalation":{"type":"boolean","description":"Explicitly permit the request to cross from customer capacity to policy-approved managed capacity."},"capacity_preference":{"type":"string","description":"Choose customer BYOK capacity first or managed capacity first. Managed-first remains subject to external-egress policy.","enum":["byok_first","managed_first"]},"allow_shared_capacity_fallback":{"type":"boolean","description":"Set false to prevent a BYOK-first request from falling back to shared managed capacity."}}}},"additionalProperties":true}}}},"responses":{"200":{"description":"Provider rerank response with MC-1 route and billing attribution","content":{"application/json":{"schema":{"type":"object","description":"Provider rerank response with MC-1 route and billing attribution","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 inference","x-implementation-source":"app/v1/rerank/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","description":"forward:dispatch or forward:deploy requires a signed-in administrator, no other scopes, and an expiry within 24 hours."}},"expires_at":{"type":"integer","description":"Optional future Unix milliseconds; required within 24 hours for Forward worker scopes."}},"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"}},"/app-setup":{"get":{"operationId":"get_app_setup","summary":"Project routing, enabled capabilities, readiness, and environment-derived Console setup/configuration URLs","description":"No body","tags":["app-setup"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Project routing, enabled capabilities, readiness, and environment-derived Console setup/configuration URLs","content":{"application/json":{"schema":{"type":"object","description":"Project routing, enabled capabilities, readiness, and environment-derived Console setup/configuration URLs","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 integration","x-implementation-source":"app/v1/app-setup/route.ts"},"post":{"operationId":"post_app_setup","summary":"Persisted project integration profile","description":"Routing mode, optional exact model, and enabled MC-1 products","tags":["app-setup"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Routing mode, optional exact model, and enabled MC-1 products","required":["routing_mode","products"],"properties":{"routing_mode":{"type":"string","enum":["smart","exact_model"]},"model_id":{"type":"string"},"products":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}},"responses":{"200":{"description":"Persisted project integration profile","content":{"application/json":{"schema":{"type":"object","description":"Persisted project integration profile","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/app-setup/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":"Unverified connection metadata","description":"Public HTTPS endpoint, explicit models, and exactly one api_key (vault enabled) or approved secret_ref. Never log the request body.","tags":["byok"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Public HTTPS endpoint, explicit models, and exactly one api_key (vault enabled) or approved secret_ref. Never log the request body.","required":["name","endpoint"],"properties":{"name":{"type":"string"},"endpoint":{"type":"string"},"template_id":{"type":"string","description":"Optional server-validated MC-1 provider-directory identity used to prevent duplicate setup cards."},"secret_ref":{"type":"string"},"api_key":{"type":"string","description":"Write-only provider key; never returned."},"custom_headers":{"type":"object","description":"Optional write-only encrypted headers: at most 16 unique case-insensitive names (64 characters), printable ASCII values (1024 characters), 8192 JSON bytes. Authentication, host, content, cookie, proxy and transport headers are reserved. Values and envelopes are never returned. Key rotation preserves headers.","additionalProperties":true},"profile":{"type":"object","description":"Optional customer-declared description, documentation_url, region, data_policy and exact model profiles (context_tokens, max_output_tokens, nullable USD pricing with source_url/as_of). Descriptive only; does not verify residency, ZDR, billing rates or activation.","additionalProperties":true},"test_before_save":{"type":"boolean","description":"Explicitly test transient credentials before storage; failures save no connection. Certification-enabled probes may incur provider charges. Successful storage remains unverified until activation."},"region":{"type":"string"},"models":{"type":"object","additionalProperties":true},"modalities":{"type":"object","additionalProperties":true},"capabilities":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"responses":{"201":{"description":"Unverified connection metadata","content":{"application/json":{"schema":{"type":"object","description":"Unverified 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"}},"/byok/{providerId}":{"post":{"operationId":"post_byok_providerId","summary":"Scoped connection test and activation result; certification scope is explicitly reported","description":"No body; tests model discovery and, when enabled, bounded chargeable compatibility probes","tags":["byok"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"providerId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Scoped connection test and activation result; certification scope is explicitly reported","content":{"application/json":{"schema":{"type":"object","description":"Scoped connection test and activation result; certification scope is explicitly reported","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/[providerId]/route.ts"},"patch":{"operationId":"patch_byok_providerId","summary":"Redacted rotated connection metadata","description":"Encrypted key rotation resets status to unverified","tags":["byok"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"providerId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Encrypted key rotation resets status to unverified","required":["api_key"],"properties":{"api_key":{"type":"string","description":"Write-only replacement key."}},"additionalProperties":true}}}},"responses":{"200":{"description":"Redacted rotated connection metadata","content":{"application/json":{"schema":{"type":"object","description":"Redacted rotated 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/[providerId]/route.ts"},"delete":{"operationId":"delete_byok_providerId","summary":"Scoped revocation result","description":"No body; revoke and erase stored connection configuration","tags":["byok"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"providerId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Scoped revocation result","content":{"application/json":{"schema":{"type":"object","description":"Scoped revocation 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 admin","x-implementation-source":"app/v1/byok/[providerId]/route.ts"}},"/provider-model-variants":{"get":{"operationId":"get_provider_model_variants","summary":"Declared canonical identities and distinct endpoint/model variants; verified canonical count remains unknown","description":"Requires MC1_PROVIDER_CATALOG_ENABLED=true; explicit public operator manifests only","tags":["provider-model-variants"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"provider_id","description":"Exact provider slug","schema":{"type":"string"},"in":"query","required":false},{"name":"canonical_model","description":"Exact declared canonical model","schema":{"type":"string"},"in":"query","required":false},{"name":"developer","description":"Exact declared developer","schema":{"type":"string"},"in":"query","required":false},{"name":"provider_model","description":"Exact provider model","schema":{"type":"string"},"in":"query","required":false},{"name":"region","description":"Exact endpoint region","schema":{"type":"string"},"in":"query","required":false},{"name":"service_tier","description":"Exact endpoint service tier","schema":{"type":"string"},"in":"query","required":false},{"name":"limit","description":"Page size","schema":{"type":"integer"},"in":"query","required":false},{"name":"offset","description":"Page offset","schema":{"type":"integer"},"in":"query","required":false}],"responses":{"200":{"description":"Declared canonical identities and distinct endpoint/model variants; verified canonical count remains unknown","content":{"application/json":{"schema":{"type":"object","description":"Declared canonical identities and distinct endpoint/model variants; verified canonical count remains unknown","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 usage:read","x-implementation-source":"app/v1/provider-model-variants/route.ts"}},"/provider-model-identities":{"get":{"operationId":"get_provider_model_identities","summary":"Source-attributed model identity evidence; no canonical total","description":"Requires MC1_PROVIDER_CATALOG_ENABLED=true; identity evidence does not enable routes","tags":["provider-model-identities"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"provider_id","description":"Exact provider ID","schema":{"type":"string"},"in":"query","required":false},{"name":"model_id","description":"Exact model ID","schema":{"type":"string"},"in":"query","required":false},{"name":"limit","description":"Page size","schema":{"type":"integer"},"in":"query","required":false},{"name":"offset","description":"Page offset","schema":{"type":"integer"},"in":"query","required":false}],"responses":{"200":{"description":"Source-attributed model identity evidence; no canonical total","content":{"application/json":{"schema":{"type":"object","description":"Source-attributed model identity evidence; no canonical total","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 usage:read","x-implementation-source":"app/v1/provider-model-identities/route.ts"}},"/connection-controls":{"get":{"operationId":"get_connection_controls","summary":"Requires MC1_CONNECTION_CONTROLS_ENABLED=true; tenant allowances, recorded spend, and unresolved holds","description":"No body","tags":["connection-controls"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Requires MC1_CONNECTION_CONTROLS_ENABLED=true; tenant allowances, recorded spend, and unresolved holds","content":{"application/json":{"schema":{"type":"object","description":"Requires MC1_CONNECTION_CONTROLS_ENABLED=true; tenant allowances, recorded spend, and unresolved holds","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/connection-controls/route.ts"}},"/connection-controls/{id}":{"put":{"operationId":"put_connection_controls_id","summary":"Replace connection allowance and priority","description":"Requires MC1_CONNECTION_CONTROLS_ENABLED=true; estimated admission allowance, not invoice hard cap","tags":["connection-controls"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Requires MC1_CONNECTION_CONTROLS_ENABLED=true; estimated admission allowance, not invoice hard cap","required":["monthly_limit_usd","priority_bias"],"properties":{"monthly_limit_usd":{"type":"number","description":"Finite amount from 0 to 1000000 USD; zero denies new covered admissions"},"priority_bias":{"type":"number","description":"Finite priority bias from -0.5 to 0.5"}},"additionalProperties":true}}}},"responses":{"200":{"description":"Replace connection allowance and priority","content":{"application/json":{"schema":{"type":"object","description":"Replace connection allowance and priority","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/connection-controls/[id]/route.ts"}},"/provider-templates":{"get":{"operationId":"get_provider_templates","summary":"Paginated source-attributed candidate catalog","description":"Requires MC1_PROVIDER_CATALOG_ENABLED=true; discovery does not enable routes","tags":["provider-templates"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"q","description":"Search name or provider ID","schema":{"type":"string"},"in":"query","required":false},{"name":"limit","description":"Page size","schema":{"type":"integer"},"in":"query","required":false},{"name":"offset","description":"Page offset","schema":{"type":"integer"},"in":"query","required":false},{"name":"view","description":"Provider or model rows","schema":{"type":"string","enum":["providers","models"]},"in":"query","required":false}],"responses":{"200":{"description":"Paginated source-attributed candidate catalog","content":{"application/json":{"schema":{"type":"object","description":"Paginated source-attributed candidate 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":"Project usage:read","x-implementation-source":"app/v1/provider-templates/route.ts"}},"/provider-applications/{applicationId}":{"get":{"operationId":"get_provider_applications_applicationId","summary":"Tenant application and immutable submission/review history, excluding internal review notes; optional selected-connection bounded certification evidence, otherwise unknown","description":"No body","tags":["provider-applications"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"connection_id","description":"Optional existing private connection ID. Same tenant, exact endpoint and complete model set must match. Read-only evidence selection; no test, activation or application approval.","schema":{"type":"string"},"in":"query","required":false}],"responses":{"200":{"description":"Tenant application and immutable submission/review history, excluding internal review notes; optional selected-connection bounded certification evidence, otherwise unknown","content":{"application/json":{"schema":{"type":"object","description":"Tenant application and immutable submission/review history, excluding internal review notes; optional selected-connection bounded certification evidence, otherwise unknown","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/provider-applications/[applicationId]/route.ts"},"post":{"operationId":"post_provider_applications_applicationId","summary":"Updated submitted application; no traffic activation or commercial approval","description":"Resubmit only after changes requested, matching the current public revision","tags":["provider-applications"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Resubmit only after changes requested, matching the current public revision","required":["expected_revision","application"],"properties":{"expected_revision":{"type":"integer"},"application":{"type":"object","description":"Complete validated replacement application, including optional technical profile.","additionalProperties":true}},"additionalProperties":true}}}},"responses":{"200":{"description":"Updated submitted application; no traffic activation or commercial approval","content":{"application/json":{"schema":{"type":"object","description":"Updated submitted application; no traffic activation or commercial approval","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/provider-applications/[applicationId]/route.ts"}},"/provider-applications/{applicationId}/compatibility-tests":{"post":{"operationId":"post_provider_applications_applicationId_compatibility_tests","summary":"Committed bounded compatibility evidence; does not grant application, commercial or traffic approval","description":"Explicitly run bounded, potentially chargeable certification against an exact tenant-owned connection matching the application endpoint and model set","tags":["provider-applications"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Explicitly run bounded, potentially chargeable certification against an exact tenant-owned connection matching the application endpoint and model set","required":["connection_id"],"properties":{"connection_id":{"type":"string","description":"Exact tenant-owned provider connection ID."}},"additionalProperties":true}}}},"responses":{"200":{"description":"Committed bounded compatibility evidence; does not grant application, commercial or traffic approval","content":{"application/json":{"schema":{"type":"object","description":"Committed bounded compatibility evidence; does not grant application, commercial or traffic approval","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/provider-applications/[applicationId]/compatibility-tests/route.ts"}},"/provider-applications":{"get":{"operationId":"get_provider_applications","summary":"Tenant-scoped technical partnership submissions","description":"No body","tags":["provider-applications"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Tenant-scoped technical partnership submissions","content":{"application/json":{"schema":{"type":"object","description":"Tenant-scoped technical partnership submissions","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/provider-applications/route.ts"},"post":{"operationId":"post_provider_applications","summary":"Submitted application; does not activate routing","description":"Technical submission only; no credentials or commercial commitment","tags":["provider-applications"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Technical submission only; no credentials or commercial commitment","required":["name","contact_email","documentation_url","api_endpoint","protocol","model_ids"],"properties":{"name":{"type":"string"},"contact_email":{"type":"string"},"documentation_url":{"type":"string"},"api_endpoint":{"type":"string"},"protocol":{"type":"string"},"model_ids":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}},"responses":{"201":{"description":"Submitted application; does not activate routing","content":{"application/json":{"schema":{"type":"object","description":"Submitted application; does not activate routing","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/provider-applications/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 assessment (201) or existing assessment replay (200)","description":"Optional assessment name and connected READ_ONLY connector references. Maximum JSON body: 16 KiB. Reuse the same Idempotency-Key and payload for safe retries; conflicting reuse returns 409.","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"Idempotency-Key","description":"Tenant-scoped retry key; retained while the assessment exists.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]{8,128}$"},"in":"header","required":false}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Optional assessment name and connected READ_ONLY connector references. Maximum JSON body: 16 KiB. Reuse the same Idempotency-Key and payload for safe retries; conflicting reuse returns 409.","required":[],"properties":{"name":{"type":"string","description":"Defaults to Transformation scan; trimmed before validation.","maxLength":120},"sources":{"type":"array","items":{"type":"string"},"maxItems":100},"connection_mode":{"type":"string","enum":["READ_ONLY"]}},"additionalProperties":true}}}},"responses":{"200":{"description":"Pending assessment (201) or existing assessment replay (200)","content":{"application/json":{"schema":{"type":"object","description":"Pending assessment (201) or existing assessment replay (200)","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"201":{"description":"Pending assessment (201) or existing assessment replay (200)","content":{"application/json":{"schema":{"type":"object","description":"Pending assessment (201) or existing assessment replay (200)","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 organization admin","x-implementation-source":"app/v1/forward/discovery/route.ts"}},"/forward/discovery/{id}/execute":{"post":{"operationId":"post_forward_discovery_id_execute","summary":"Completed read-only discovery or completed-run replay (200). Requires operator-enabled execution, current discovery entitlement and 1–10 approved public GitHub metadata sources. Running lease conflicts return 409; private sources are rejected.","description":"No body","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Completed read-only discovery or completed-run replay (200). Requires operator-enabled execution, current discovery entitlement and 1–10 approved public GitHub metadata sources. Running lease conflicts return 409; private sources are rejected.","content":{"application/json":{"schema":{"type":"object","description":"Completed read-only discovery or completed-run replay (200). Requires operator-enabled execution, current discovery entitlement and 1–10 approved public GitHub metadata sources. Running lease conflicts return 409; private sources are rejected.","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 organization admin","x-implementation-source":"app/v1/forward/discovery/[id]/execute/route.ts"}},"/forward/deployments":{"get":{"operationId":"get_forward_deployments","summary":"Durable prepared operation metadata and execution history; no execution request","description":"No body","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Durable prepared operation metadata and execution history; no execution request","content":{"application/json":{"schema":{"type":"object","description":"Durable prepared operation metadata and execution history; no execution request","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 organization reader","x-implementation-source":"app/v1/forward/deployments/route.ts"},"post":{"operationId":"post_forward_deployments","summary":"Idempotent prepared operation with executable=false; does not consume approval or deploy","description":"Prepare a signed release using an independently approved artifact and configured target","tags":["forward"],"security":[{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Prepare a signed release using an independently approved artifact and configured target","required":["approval_id","target_id"],"properties":{"approval_id":{"type":"string"},"target_id":{"type":"string"}},"additionalProperties":true}}}},"responses":{"201":{"description":"Idempotent prepared operation with executable=false; does not consume approval or deploy","content":{"application/json":{"schema":{"type":"object","description":"Idempotent prepared operation with executable=false; does not consume approval or deploy","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 organization admin","x-implementation-source":"app/v1/forward/deployments/route.ts"}},"/forward/deployments/recovery":{"post":{"operationId":"post_forward_deployments_recovery","summary":"Durable recovery request with executable=false","description":"Record rollback intent for an interrupted operation; never executes deployment","tags":["forward"],"security":[{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Record rollback intent for an interrupted operation; never executes deployment","required":["operation_id","request_id","reason"],"properties":{"operation_id":{"type":"string"},"request_id":{"type":"string"},"reason":{"type":"string"},"expected_request_id":{"type":"string"}},"additionalProperties":true}}}},"responses":{"201":{"description":"Durable recovery request with executable=false","content":{"application/json":{"schema":{"type":"object","description":"Durable recovery request with executable=false","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 organization admin","x-implementation-source":"app/v1/forward/deployments/recovery/route.ts"}},"/forward/jobs":{"get":{"operationId":"get_forward_jobs","summary":"Recent tenant-scoped discovery jobs, retry counts and sanitized error codes","description":"No body","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Recent tenant-scoped discovery jobs, retry counts and sanitized error codes","content":{"application/json":{"schema":{"type":"object","description":"Recent tenant-scoped discovery jobs, retry counts and sanitized error codes","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 organization reader","x-implementation-source":"app/v1/forward/jobs/route.ts"}},"/forward/initiatives":{"get":{"operationId":"get_forward_initiatives","summary":"Recent initiative workspaces and fourteen stage records","description":"No body","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Recent initiative workspaces and fourteen stage records","content":{"application/json":{"schema":{"type":"object","description":"Recent initiative workspaces and fourteen stage records","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 organization reader","x-implementation-source":"app/v1/forward/initiatives/route.ts"},"post":{"operationId":"post_forward_initiatives","summary":"Initiative and pending lifecycle stages; no automatic implementation","description":"Create an initiative charter with an organization member as owner","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"Idempotency-Key","description":"Required tenant-scoped retry key; conflicting payload reuse returns 409.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]{8,128}$"},"required":true,"in":"header"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Create an initiative charter with an organization member as owner","required":["title","owner_id","business_problem","acceptance_criteria"],"properties":{"title":{"type":"string"},"owner_id":{"type":"string"},"business_problem":{"type":"string"},"acceptance_criteria":{"type":"string"}},"additionalProperties":true}}}},"responses":{"201":{"description":"Initiative and pending lifecycle stages; no automatic implementation","content":{"application/json":{"schema":{"type":"object","description":"Initiative and pending lifecycle stages; no automatic implementation","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 organization admin","x-implementation-source":"app/v1/forward/initiatives/route.ts"}},"/forward/initiatives/{id}":{"get":{"operationId":"get_forward_initiatives_id","summary":"Charter, stage records, immutable artifact contents and approval metadata","description":"No body","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Charter, stage records, immutable artifact contents and approval metadata","content":{"application/json":{"schema":{"type":"object","description":"Charter, stage records, immutable artifact contents and approval 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":"Forward organization reader","x-implementation-source":"app/v1/forward/initiatives/[id]/route.ts"}},"/forward/initiatives/{id}/status":{"post":{"operationId":"post_forward_initiatives_id_status","summary":"Updated initiative status and version; archived workspaces cannot reopen","description":"Version-checked pause, resume or archive with a reason; pause and archive revoke outstanding approvals","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Version-checked pause, resume or archive with a reason; pause and archive revoke outstanding approvals","required":["status","version","reason"],"properties":{"status":{"type":"string","enum":["active","paused","archived"]},"version":{"type":"integer"},"reason":{"type":"string"}},"additionalProperties":true}}}},"responses":{"200":{"description":"Updated initiative status and version; archived workspaces cannot reopen","content":{"application/json":{"schema":{"type":"object","description":"Updated initiative status and version; archived workspaces cannot reopen","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 organization admin","x-implementation-source":"app/v1/forward/initiatives/[id]/status/route.ts"}},"/forward/initiatives/{id}/artifacts":{"get":{"operationId":"get_forward_initiatives_id_artifacts","summary":"Immutable artifact metadata and SHA-256 content hashes","description":"No body","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Immutable artifact metadata and SHA-256 content hashes","content":{"application/json":{"schema":{"type":"object","description":"Immutable artifact metadata and SHA-256 content hashes","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 organization reader","x-implementation-source":"app/v1/forward/initiatives/[id]/artifacts/route.ts"},"post":{"operationId":"post_forward_initiatives_id_artifacts","summary":"Immutable artifact hash; evidence recording does not complete the stage","description":"Record user-provided evidence for one stage","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","description":"Required tenant-scoped retry key; conflicting payload reuse returns 409.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]{8,128}$"},"required":true,"in":"header"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Record user-provided evidence for one stage","required":["stage","kind","summary","source"],"properties":{"stage":{"type":"string","enum":["Connect","Discover","Map","Diagnose","Prioritize","Design","Simulate","Approve","Implement","Validate","Deploy","Observe","Measure","Improve"]},"kind":{"type":"string"},"summary":{"type":"string"},"source":{"type":"string"},"release":{"type":"object","description":"Required for release artifacts: signed version-1 manifest bound to image, source commit, rollback image, target and check evidence.","additionalProperties":true}},"additionalProperties":true}}}},"responses":{"200":{"description":"Immutable artifact hash; evidence recording does not complete the stage","content":{"application/json":{"schema":{"type":"object","description":"Immutable artifact hash; evidence recording does not complete the stage","properties":{"object":{"type":"string","description":"Stable resource or collection discriminator when present."}},"additionalProperties":true}}}},"201":{"description":"Immutable artifact hash; evidence recording does not complete the stage","content":{"application/json":{"schema":{"type":"object","description":"Immutable artifact hash; evidence recording does not complete the stage","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 organization admin","x-implementation-source":"app/v1/forward/initiatives/[id]/artifacts/route.ts"}},"/forward/initiatives/{id}/approvals":{"post":{"operationId":"post_forward_initiatives_id_approvals","summary":"Pending approval metadata with executable=false; no deployment driver is enabled","description":"Request human review bound to artifact hash, action, environment and expiry; deploy requires a trusted signed release manifest","tags":["forward"],"security":[{"siteSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","description":"Required tenant-scoped retry key; conflicting payload reuse returns 409.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]{8,128}$"},"required":true,"in":"header"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request human review bound to artifact hash, action, environment and expiry; deploy requires a trusted signed release manifest","required":["artifact_id","action","environment","expires_at"],"properties":{"artifact_id":{"type":"string"},"action":{"type":"string","enum":["sandbox","implement","deploy"]},"environment":{"type":"string","enum":["staging","production"]},"expires_at":{"type":"integer","description":"Unix milliseconds, future and within 24 hours"}},"additionalProperties":true}}}},"responses":{"201":{"description":"Pending approval metadata with executable=false; no deployment driver is enabled","content":{"application/json":{"schema":{"type":"object","description":"Pending approval metadata with executable=false; no deployment driver is enabled","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 organization admin","x-implementation-source":"app/v1/forward/initiatives/[id]/approvals/route.ts"}},"/forward/approvals/{id}/review":{"post":{"operationId":"post_forward_approvals_id_review","summary":"Hash-bound review state with executable=false","description":"Approve or revoke with a reason; approving requires a reviewer distinct from requester and artifact author","tags":["forward"],"security":[{"siteSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Approve or revoke with a reason; approving requires a reviewer distinct from requester and artifact author","required":["decision","reason"],"properties":{"decision":{"type":"string","enum":["approve","revoke"]},"reason":{"type":"string"}},"additionalProperties":true}}}},"responses":{"200":{"description":"Hash-bound review state with executable=false","content":{"application/json":{"schema":{"type":"object","description":"Hash-bound review state with executable=false","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 human organization admin","x-implementation-source":"app/v1/forward/approvals/[id]/review/route.ts"}},"/forward/initiatives/{id}/outcomes":{"get":{"operationId":"get_forward_initiatives_id_outcomes","summary":"Reported observations with USER_PROVIDED provenance and production_validated=false","description":"No body","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Reported observations with USER_PROVIDED provenance and production_validated=false","content":{"application/json":{"schema":{"type":"object","description":"Reported observations with USER_PROVIDED provenance and production_validated=false","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 organization reader","x-implementation-source":"app/v1/forward/initiatives/[id]/outcomes/route.ts"},"post":{"operationId":"post_forward_initiatives_id_outcomes","summary":"Deduplicated reported observation; no independent ROI validation or attribution","description":"Record a numeric baseline or observation with source, method and timestamp","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Record a numeric baseline or observation with source, method and timestamp","required":["metric","unit","value","observation_type","source","method","observed_at"],"properties":{"metric":{"type":"string"},"unit":{"type":"string"},"value":{"type":"number"},"observation_type":{"type":"string","enum":["baseline","observation"]},"source":{"type":"string"},"method":{"type":"string"},"observed_at":{"type":"integer","description":"Unix milliseconds, not in the future"}},"additionalProperties":true}}}},"responses":{"201":{"description":"Deduplicated reported observation; no independent ROI validation or attribution","content":{"application/json":{"schema":{"type":"object","description":"Deduplicated reported observation; no independent ROI validation or attribution","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 organization admin","x-implementation-source":"app/v1/forward/initiatives/[id]/outcomes/route.ts"}},"/forward/initiatives/{id}/outcomes/compare":{"get":{"operationId":"get_forward_initiatives_id_outcomes_compare","summary":"Reported arithmetic comparison, source provenance and audit hash; no causal attribution or confidence claim","description":"Compare explicit baseline_id and observation_id query parameters with matching metric, unit and method","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"baseline_id","description":"Exact tenant-owned measurement identifier","schema":{"type":"string","minLength":1,"maxLength":128},"required":true,"in":"query"},{"name":"observation_id","description":"Exact tenant-owned measurement identifier","schema":{"type":"string","minLength":1,"maxLength":128},"required":true,"in":"query"}],"responses":{"200":{"description":"Reported arithmetic comparison, source provenance and audit hash; no causal attribution or confidence claim","content":{"application/json":{"schema":{"type":"object","description":"Reported arithmetic comparison, source provenance and audit hash; no causal attribution or confidence claim","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 organization read","x-implementation-source":"app/v1/forward/initiatives/[id]/outcomes/compare/route.ts"}},"/forward/discovery/{id}/enqueue":{"post":{"operationId":"post_forward_discovery_id_enqueue","summary":"Durable discovery job (202); one job per assessment; orchestration must be enabled","description":"No body","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"Durable discovery job (202); one job per assessment; orchestration must be enabled","content":{"application/json":{"schema":{"type":"object","description":"Durable discovery job (202); one job per assessment; orchestration must be enabled","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 organization admin","x-implementation-source":"app/v1/forward/discovery/[id]/enqueue/route.ts"}},"/forward/jobs/dispatch":{"post":{"operationId":"post_forward_jobs_dispatch","summary":"One due job dispatch, reconciliation, or idle response. Uses persisted backoff and a five-attempt budget.","description":"No body","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"One due job dispatch, reconciliation, or idle response. Uses persisted backoff and a five-attempt budget.","content":{"application/json":{"schema":{"type":"object","description":"One due job dispatch, reconciliation, or idle response. Uses persisted backoff and a five-attempt budget.","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 organization forward:dispatch service key or admin","x-implementation-source":"app/v1/forward/jobs/dispatch/route.ts"}},"/forward/jobs/{id}/cancel":{"post":{"operationId":"post_forward_jobs_id_cancel","summary":"Audited cancellation of unfinished queued discovery; completed observations are retained","description":"No body","tags":["forward"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Audited cancellation of unfinished queued discovery; completed observations are retained","content":{"application/json":{"schema":{"type":"object","description":"Audited cancellation of unfinished queued discovery; completed observations are retained","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 organization admin","x-implementation-source":"app/v1/forward/jobs/[id]/cancel/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"}},"/trust/overview":{"get":{"operationId":"get_trust_overview","summary":"Fresh tenant-scoped Trust counts and agent assurance states","description":"No body","tags":["trust"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Fresh tenant-scoped Trust counts and agent assurance states","content":{"application/json":{"schema":{"type":"object","description":"Fresh tenant-scoped Trust counts and agent assurance states","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 usage reader; MC1_TRUST_ENABLED","x-implementation-source":"app/v1/trust/overview/route.ts"}},"/trust/workload-grants":{"get":{"operationId":"get_trust_workload_grants","summary":"Audited evidence-only workload grant inventory","description":"No body","tags":["trust"],"security":[{"siteSession":[]}],"responses":{"200":{"description":"Audited evidence-only workload grant inventory","content":{"application/json":{"schema":{"type":"object","description":"Audited evidence-only workload grant 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":"Signed-in owner/admin; managed ingestion enabled","x-implementation-source":"app/v1/trust/workload-grants/route.ts"},"post":{"operationId":"post_trust_workload_grants","summary":"New evidence-only grant; no automatic renewal or intervention","description":"Exact pinned agent, explicit expiry within 24 hours and typed confirmation","tags":["trust"],"security":[{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Exact pinned agent, explicit expiry within 24 hours and typed confirmation","required":["agent_id","expires_at","confirmation"],"properties":{"agent_id":{"type":"string"},"expires_at":{"type":"integer"},"confirmation":{"type":"string"}},"additionalProperties":true}}}},"responses":{"201":{"description":"New evidence-only grant; no automatic renewal or intervention","content":{"application/json":{"schema":{"type":"object","description":"New evidence-only grant; no automatic renewal or intervention","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 owner/admin; managed ingestion enabled","x-implementation-source":"app/v1/trust/workload-grants/route.ts"},"delete":{"operationId":"delete_trust_workload_grants","summary":"Centrally revoked evidence-only grant","description":"Grant ID and exact typed revocation confirmation","tags":["trust"],"security":[{"siteSession":[]}],"responses":{"200":{"description":"Centrally revoked evidence-only grant","content":{"application/json":{"schema":{"type":"object","description":"Centrally revoked evidence-only grant","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 owner/admin; managed ingestion enabled","x-implementation-source":"app/v1/trust/workload-grants/route.ts"}},"/trust/agents":{"get":{"operationId":"get_trust_agents","summary":"Tenant-scoped Trust agents","description":"No body","tags":["trust"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"responses":{"200":{"description":"Tenant-scoped Trust agents","content":{"application/json":{"schema":{"type":"object","description":"Tenant-scoped Trust agents","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 usage reader; MC1_TRUST_ENABLED","x-implementation-source":"app/v1/trust/agents/route.ts"},"post":{"operationId":"post_trust_agents","summary":"CANDIDATE agent; no certification","description":"Scoped agent registration and action policy","tags":["trust"],"security":[{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Scoped agent registration and action policy","required":["name","owner_user_id","capability_gate","scope","policy"],"properties":{"name":{"type":"string"},"owner_user_id":{"type":"string"},"capability_gate":{"type":"integer"},"scope":{"type":"object","additionalProperties":true},"policy":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"responses":{"201":{"description":"CANDIDATE agent; no certification","content":{"application/json":{"schema":{"type":"object","description":"CANDIDATE agent; no certification","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 admin; MC1_TRUST_ENABLED","x-implementation-source":"app/v1/trust/agents/route.ts"}},"/trust/agents/{agentId}":{"get":{"operationId":"get_trust_agents_agentId","summary":"Agent scope and live effective assurance state","description":"No body","tags":["trust"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Agent scope and live effective assurance state","content":{"application/json":{"schema":{"type":"object","description":"Agent scope and live effective assurance 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 usage reader","x-implementation-source":"app/v1/trust/agents/[agentId]/route.ts"},"patch":{"operationId":"patch_trust_agents_agentId","summary":"Updated agent; material change invalidates certificates","description":"Versioned configuration change","tags":["trust"],"security":[{"siteSession":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Versioned configuration change","required":["version"],"properties":{"version":{"type":"integer"},"name":{"type":"string"},"capability_gate":{"type":"integer"},"scope":{"type":"object","additionalProperties":true},"policy":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"responses":{"200":{"description":"Updated agent; material change invalidates certificates","content":{"application/json":{"schema":{"type":"object","description":"Updated agent; material change invalidates certificates","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 admin","x-implementation-source":"app/v1/trust/agents/[agentId]/route.ts"}},"/trust/agents/{agentId}/evidence":{"get":{"operationId":"get_trust_agents_agentId_evidence","summary":"Evidence metadata, digests and freshness; payloads excluded","description":"No body","tags":["trust"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Evidence metadata, digests and freshness; payloads excluded","content":{"application/json":{"schema":{"type":"object","description":"Evidence metadata, digests and freshness; payloads excluded","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 usage reader","x-implementation-source":"app/v1/trust/agents/[agentId]/evidence/route.ts"},"post":{"operationId":"post_trust_agents_agentId_evidence","summary":"Immutable evidence receipt; current certificate revoked","description":"Encrypted evidence payload for one AATS control","tags":["trust"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Encrypted evidence payload for one AATS control","required":["control_id","source","payload","observed_at","expires_at"],"properties":{"control_id":{"type":"string"},"source":{"type":"string"},"payload":{"type":"object","additionalProperties":true},"observed_at":{"type":"integer"},"expires_at":{"type":"integer"}},"additionalProperties":true}}}},"responses":{"201":{"description":"Immutable evidence receipt; current certificate revoked","content":{"application/json":{"schema":{"type":"object","description":"Immutable evidence receipt; current certificate revoked","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/trust/agents/[agentId]/evidence/route.ts"}},"/trust/agents/{agentId}/evidence/{evidenceId}":{"get":{"operationId":"get_trust_agents_agentId_evidence_evidenceId","summary":"Decrypted evidence payload with audited read","description":"No body","tags":["trust"],"security":[{"siteSession":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"evidenceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Decrypted evidence payload with audited read","content":{"application/json":{"schema":{"type":"object","description":"Decrypted evidence payload with audited read","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 admin","x-implementation-source":"app/v1/trust/agents/[agentId]/evidence/[evidenceId]/route.ts"}},"/trust/agents/{agentId}/assessments":{"get":{"operationId":"get_trust_agents_agentId_assessments","summary":"Assessment history without private evidence payloads","description":"No body","tags":["trust"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Assessment history without private evidence payloads","content":{"application/json":{"schema":{"type":"object","description":"Assessment history without private evidence payloads","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 usage reader","x-implementation-source":"app/v1/trust/agents/[agentId]/assessments/route.ts"},"post":{"operationId":"post_trust_agents_agentId_assessments","summary":"Signed certificate or restrictive state","description":"Approved or rejected decision with rationale","tags":["trust"],"security":[{"siteSession":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Approved or rejected decision with rationale","required":["decision","rationale"],"properties":{"decision":{"type":"string","enum":["approved","rejected"]},"rationale":{"type":"string"}},"additionalProperties":true}}}},"responses":{"201":{"description":"Signed certificate or restrictive state","content":{"application/json":{"schema":{"type":"object","description":"Signed certificate or restrictive 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":"Configured independent signed-in evaluator; certification feature enabled","x-implementation-source":"app/v1/trust/agents/[agentId]/assessments/route.ts"}},"/trust/agents/{agentId}/status":{"get":{"operationId":"get_trust_agents_agentId_status","summary":"Effective state recomputed from fresh evidence, assessment and certificate","description":"No body","tags":["trust"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Effective state recomputed from fresh evidence, assessment and certificate","content":{"application/json":{"schema":{"type":"object","description":"Effective state recomputed from fresh evidence, assessment and certificate","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 usage reader","x-implementation-source":"app/v1/trust/agents/[agentId]/status/route.ts"}},"/trust/agents/{agentId}/events":{"get":{"operationId":"get_trust_agents_agentId_events","summary":"Audited Trust state transition history","description":"No body","tags":["trust"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Audited Trust state transition history","content":{"application/json":{"schema":{"type":"object","description":"Audited Trust state transition history","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 usage reader","x-implementation-source":"app/v1/trust/agents/[agentId]/events/route.ts"}},"/trust/agents/{agentId}/state":{"post":{"operationId":"post_trust_agents_agentId_state","summary":"Suspended, revoked or review-required state; current certificate revoked","description":"Restrictive transition and reason","tags":["trust"],"security":[{"siteSession":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Restrictive transition and reason","required":["status","reason","version"],"properties":{"status":{"type":"string","enum":["SUSPENDED","REVOKED","REVIEW_REQUIRED"]},"reason":{"type":"string"},"version":{"type":"integer"}},"additionalProperties":true}}}},"responses":{"200":{"description":"Suspended, revoked or review-required state; current certificate revoked","content":{"application/json":{"schema":{"type":"object","description":"Suspended, revoked or review-required state; current certificate revoked","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 admin","x-implementation-source":"app/v1/trust/agents/[agentId]/state/route.ts"}},"/trust/decisions":{"post":{"operationId":"post_trust_decisions","summary":"Fail-closed advisory allow or deny decision; enforcement integration remains separate","description":"Agent ID and exact action","tags":["trust"],"security":[{"bearerAuth":[]},{"siteSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Agent ID and exact action","required":["agent_id","action"],"properties":{"agent_id":{"type":"string"},"action":{"type":"string"}},"additionalProperties":true}}}},"responses":{"200":{"description":"Fail-closed advisory allow or deny decision; enforcement integration remains separate","content":{"application/json":{"schema":{"type":"object","description":"Fail-closed advisory allow or deny decision; enforcement integration remains separate","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 usage reader","x-implementation-source":"app/v1/trust/decisions/route.ts"}},"/trust/registry/{certificateId}":{"get":{"operationId":"get_trust_registry_certificateId","summary":"Signed scoped certificate and current status; no private evidence","description":"No body","tags":["trust"],"security":[],"parameters":[{"name":"certificateId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Signed scoped certificate and current status; no private evidence","content":{"application/json":{"schema":{"type":"object","description":"Signed scoped certificate and current status; no private 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":"Public","x-implementation-source":"app/v1/trust/registry/[certificateId]/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"}}}}