{ "openapi": "3.1.0", "info": { "title": "xAgent ID API", "version": "0.3.19" }, "servers": [ { "url": "https://xagent.id" } ], "paths": { "/a2a/v1/message:send": { "post": { "summary": "Submit an authenticated A2A 1.0 message to the Agent ID runtime.", "x-auth": "Bearer credential bound to the verified website and agent:audit scope.", "x-a2a-version": "1.0", "operationId": "post_a2a_v1_message_send", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/a2a/v1/message:stream": { "post": { "summary": "Stream an authenticated A2A 1.0 task lifecycle as finite server-sent events.", "x-auth": "Bearer credential bound to the verified website and agent:audit scope.", "x-a2a-version": "1.0", "x-runtime-status": "finite_sse_enabled", "operationId": "post_a2a_v1_message_stream", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/a2a/v1/tasks/{task_id}:cancel": { "post": { "summary": "Cancel an authenticated A2A 1.0 task owned by the calling website agent.", "x-auth": "Bearer credential bound to the verified website and agent:audit scope.", "x-a2a-version": "1.0", "operationId": "post_a2a_v1_tasks_task_id_cancel", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/a2a/v0.3/v1/message:send": { "post": { "summary": "Submit an authenticated message through the Gemini Enterprise A2A 0.3 compatibility path.", "x-auth": "Bearer credential bound to the verified website and agent:audit scope.", "x-a2a-version": "0.3", "operationId": "post_a2a_v0_3_v1_message_send", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/a2a/v0.3/v1/message:stream": { "post": { "summary": "Stream an authenticated A2A 0.3-compatible task lifecycle as finite server-sent events for Gemini Enterprise interoperability.", "x-auth": "Bearer credential bound to the verified website and agent:audit scope.", "x-a2a-version": "0.3", "x-runtime-status": "finite_sse_enabled", "operationId": "post_a2a_v0_3_v1_message_stream", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/a2a/v0.3/v1/tasks/{task_id}:cancel": { "post": { "summary": "Cancel an authenticated task through the A2A 0.3 compatibility path.", "x-auth": "Bearer credential bound to the verified website and agent:audit scope.", "x-a2a-version": "0.3", "operationId": "post_a2a_v0_3_v1_tasks_task_id_cancel", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/trust_verify": { "post": { "summary": "Verify a portable Agent trust bundle offline-compatible and fail closed on tampering.", "operationId": "post_portable_trust_verification", "x-mcp-tool": "portable_trust_verification", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/continuous_trust_graph": { "post": { "summary": "Evaluate Trust Claims, runtime receipts, revocations, expiry, and conflicts.", "operationId": "post_continuous_trust_graph", "x-mcp-tool": "continuous_trust_graph", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/tenant_zero_trust_gate": { "post": { "summary": "Gate Tenant 0 with external black-box negative tests and independent public refetch.", "operationId": "post_tenant_zero_trust_gate", "x-mcp-tool": "tenant_zero_trust_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/continuous_observation_gate": { "post": { "summary": "Gate a continuous observation window from real checkpoint samples.", "operationId": "post_continuous_observation_gate", "x-mcp-tool": "continuous_observation_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/external_pilot_trust_gate": { "post": { "summary": "Require two independently verified external website pilots.", "operationId": "post_external_pilot_trust_gate", "x-mcp-tool": "external_pilot_trust_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_trust_gate": { "post": { "summary": "Require real external Google review receipts before Marketplace readiness claims.", "operationId": "post_google_marketplace_trust_gate", "x-mcp-tool": "google_marketplace_trust_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/capabilities": { "get": { "summary": "Describe the two AEO Agent product lanes.", "operationId": "get_api_agent_capabilities", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/.well-known/agent-id.json": { "get": { "summary": "Return the public portable Agent ID alias, capability index, platform-identity boundary, and discovery links without credentials or secrets.", "operationId": "get_well_known_agent_id_json", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/.well-known/agent-id-release.json": { "get": { "summary": "Return the signed release manifest; responds 503 until the stable API origin, npm integrity, provenance, commit, and issuer signature are configured.", "operationId": "get_well_known_agent_id_release_json", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/.well-known/agent-id-release-receipt.json": { "get": { "summary": "Return the signed npm, Git, Cloud Run revision, image, install manifest, Agent Card, and OpenAPI binding receipt.", "operationId": "get_well_known_agent_id_release_receipt_json", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/workflow_router": { "get": { "summary": "Return the W1 workflow router for audit, content, measurement, or Site Agent installation.", "operationId": "get_w1_workflow_router", "x-mcp-tool": "w1_workflow_router", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Choose the next AEO workflow route from a supplied intent, target URL, and evidence context.", "operationId": "post_w1_workflow_router", "x-mcp-tool": "w1_workflow_router", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/package_review": { "get": { "summary": "Return the S2 Agent package review for marketplace scanners.", "operationId": "get_s2_package_review", "x-mcp-tool": "s2_package_review", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Review package capability, credential, persistence, privilege, and claim-boundary metadata.", "operationId": "post_s2_package_review", "x-mcp-tool": "s2_package_review", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/skill_package_validate": { "get": { "summary": "Generate and validate an S1 Skill package.", "operationId": "get_s1_skill_package_validation", "x-mcp-tool": "s1_skill_package_validation", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Validate a submitted S1 Skill package without executing package code.", "operationId": "post_s1_skill_package_validation", "x-mcp-tool": "s1_skill_package_validation", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "package": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/marketplace_submission": { "get": { "summary": "Generate an Agent Store / registry submission pack with validation and claim boundaries.", "operationId": "get_marketplace_submission_pack", "x-mcp-tool": "marketplace_submission_pack", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate a submission pack from supplied listing, public metadata, and setup metadata.", "operationId": "post_marketplace_submission_pack", "x-mcp-tool": "marketplace_submission_pack", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/marketplace_readiness": { "get": { "summary": "Score Agent Store / registry submission readiness and list blockers.", "operationId": "get_marketplace_readiness_score", "x-mcp-tool": "marketplace_readiness_score", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Score a supplied or generated submission pack without claiming platform approval.", "operationId": "post_marketplace_readiness_score", "x-mcp-tool": "marketplace_readiness_score", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "submission": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/marketplace_approval_receipts": { "get": { "summary": "Summarize marketplace or registry approval receipts for a verified website agent.", "operationId": "get_marketplace_approval_receipts", "x-mcp-tool": "marketplace_approval_receipts", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Normalize and store a marketplace or registry approval receipt with claim boundaries.", "operationId": "post_marketplace_approval_receipts", "x-mcp-tool": "marketplace_approval_receipts", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/trust_package": { "get": { "summary": "Return an Agent trust package for external Agent or marketplace reviewers.", "operationId": "get_agent_trust_package", "x-mcp-tool": "agent_trust_package", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate an Agent trust package from supplied subject or evidence context.", "operationId": "post_agent_trust_package", "x-mcp-tool": "agent_trust_package", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_agent_card": { "get": { "summary": "Return a Google Cloud Marketplace-oriented A2A Agent Card candidate.", "operationId": "get_google_marketplace_agent_card", "x-mcp-tool": "google_marketplace_agent_card", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate a Google Marketplace Agent Card from supplied product metadata.", "operationId": "post_google_marketplace_agent_card", "x-mcp-tool": "google_marketplace_agent_card", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "product_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_submission": { "get": { "summary": "Return Google Cloud Marketplace AI Agent submission materials.", "operationId": "get_google_marketplace_submission_pack", "x-mcp-tool": "google_marketplace_submission_pack", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate Google Marketplace submission materials from supplied product and integration metadata.", "operationId": "post_google_marketplace_submission_pack", "x-mcp-tool": "google_marketplace_submission_pack", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "product_metadata": { "type": "object" }, "setup_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_readiness": { "get": { "summary": "Score Google Cloud Marketplace AI Agent submission readiness.", "operationId": "get_google_marketplace_readiness_score", "x-mcp-tool": "google_marketplace_readiness_score", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Score Google Marketplace readiness from supplied onboarding, pricing, and technical integration evidence.", "operationId": "post_google_marketplace_readiness_score", "x-mcp-tool": "google_marketplace_readiness_score", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "submission": { "type": "object" }, "product_metadata": { "type": "object" }, "setup_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_pricing": { "get": { "summary": "Return Google Marketplace AI Agent pricing review material.", "operationId": "get_google_marketplace_pricing_pack", "x-mcp-tool": "google_marketplace_pricing_pack", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate pricing review material from supplied plan metadata.", "operationId": "post_google_marketplace_pricing_pack", "x-mcp-tool": "google_marketplace_pricing_pack", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_develop_flow_gate": { "get": { "summary": "Map Google's Marketplace develop flow to AgentX evidence files.", "operationId": "get_google_marketplace_develop_flow_gate", "x-mcp-tool": "google_marketplace_develop_flow_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Evaluate supplied evidence against the Google Marketplace develop flow.", "operationId": "post_google_marketplace_develop_flow_gate", "x-mcp-tool": "google_marketplace_develop_flow_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "setup_metadata": { "type": "object" }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_listing_requirements_gate": { "get": { "summary": "Track Google Marketplace listing requirements evidence.", "operationId": "get_google_marketplace_listing_requirements_gate", "x-mcp-tool": "google_marketplace_listing_requirements_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Evaluate supplied product and organization evidence against Google Marketplace listing requirements.", "operationId": "post_google_marketplace_listing_requirements_gate", "x-mcp-tool": "google_marketplace_listing_requirements_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "product_metadata": { "type": "object" }, "setup_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_listing": { "get": { "summary": "Return Google Marketplace product details and AI discovery listing metadata.", "operationId": "get_google_marketplace_listing_pack", "x-mcp-tool": "google_marketplace_listing_pack", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate product details and listing metadata from supplied product metadata.", "operationId": "post_google_marketplace_listing_pack", "x-mcp-tool": "google_marketplace_listing_pack", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "product_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_discovery_metadata": { "get": { "summary": "Validate explicit Google Marketplace AI discovery metadata.", "operationId": "get_google_marketplace_discovery_metadata_gate", "x-mcp-tool": "google_marketplace_discovery_metadata_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Validate supplied Industry, Business function, Category IDs, and Product Overview metadata.", "operationId": "post_google_marketplace_discovery_metadata_gate", "x-mcp-tool": "google_marketplace_discovery_metadata_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "product_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_product_details_review_gate": { "get": { "summary": "Track Google Marketplace Product details review evidence.", "operationId": "get_google_marketplace_product_details_review_gate", "x-mcp-tool": "google_marketplace_product_details_review_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Evaluate Product details readiness from supplied metadata and Producer Portal review receipt.", "operationId": "post_google_marketplace_product_details_review_gate", "x-mcp-tool": "google_marketplace_product_details_review_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "product_metadata": { "type": "object" }, "setup_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_technical": { "get": { "summary": "Return Google Marketplace technical integration review material.", "operationId": "get_google_marketplace_technical_integration_pack", "x-mcp-tool": "google_marketplace_technical_integration_pack", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate technical integration review material from supplied setup and pricing metadata.", "operationId": "post_google_marketplace_technical_integration_pack", "x-mcp-tool": "google_marketplace_technical_integration_pack", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "setup_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_backend_gate": { "get": { "summary": "Gate Google Marketplace backend integration evidence.", "operationId": "get_google_marketplace_backend_gate", "x-mcp-tool": "google_marketplace_backend_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Evaluate backend readiness from supplied Pub/Sub, Procurement, JWT, entitlement, and usage-reporting evidence.", "operationId": "post_google_marketplace_backend_gate", "x-mcp-tool": "google_marketplace_backend_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "setup_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_lifecycle_smoke": { "get": { "summary": "Run a local Google Marketplace procurement lifecycle smoke test.", "operationId": "get_google_marketplace_lifecycle_smoke", "x-mcp-tool": "google_marketplace_lifecycle_smoke", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Run lifecycle smoke with supplied provider, account, or entitlement identifiers.", "operationId": "post_google_marketplace_lifecycle_smoke", "x-mcp-tool": "google_marketplace_lifecycle_smoke", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_runtime_smoke": { "get": { "summary": "Run a local Google Marketplace runtime smoke across account linking, procurement, and usage-reporting dry-run gates.", "operationId": "get_google_marketplace_runtime_smoke", "x-mcp-tool": "google_marketplace_runtime_smoke", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Run runtime smoke with supplied provider, account, entitlement, or pricing identifiers.", "operationId": "post_google_marketplace_runtime_smoke", "x-mcp-tool": "google_marketplace_runtime_smoke", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_runtime_receipt": { "post": { "summary": "Generate and optionally store a server-attested Google Marketplace runtime receipt from a real JWT, Pub/Sub, Procurement API, or Service Control signal.", "operationId": "post_google_marketplace_runtime_receipt", "x-mcp-tool": "google_marketplace_runtime_receipt", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "evidence_type": { "type": "string" }, "evidence": { "type": "object" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "certs": { "type": "object" }, "payload": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "pricing_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_model_armor_runtime_evidence": { "post": { "summary": "Run operator-authenticated fixed Model Armor allow, block, and fail-closed probes and return redacted runtime-bound receipts.", "operationId": "post_api_agent_google_marketplace_model_armor_runtime_evidence", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_runtime_evidence_ledger": { "get": { "summary": "Return the redacted Google Marketplace runtime evidence ledger.", "operationId": "get_google_marketplace_runtime_evidence_ledger", "x-mcp-tool": "google_marketplace_runtime_evidence_ledger", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Append runtime evidence receipts and recompute the strict runtime evidence gate.", "operationId": "post_google_marketplace_runtime_evidence_ledger", "x-mcp-tool": "google_marketplace_runtime_evidence_ledger", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "pricing_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_runtime_evidence_gate": { "get": { "summary": "Gate real Google Marketplace runtime evidence separately from synthetic smoke.", "operationId": "get_google_marketplace_runtime_evidence_gate", "x-mcp-tool": "google_marketplace_runtime_evidence_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Evaluate JWT, Pub/Sub, procurement, usage, and test billing runtime evidence.", "operationId": "post_google_marketplace_runtime_evidence_gate", "x-mcp-tool": "google_marketplace_runtime_evidence_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "setup_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_test_billing_gate": { "get": { "summary": "Track Google Marketplace test billing, preview, purchase-flow, and usage evidence.", "operationId": "get_google_marketplace_test_billing_gate", "x-mcp-tool": "google_marketplace_test_billing_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Evaluate test billing readiness from supplied Google preview, purchase, and usage-reporting evidence.", "operationId": "post_google_marketplace_test_billing_gate", "x-mcp-tool": "google_marketplace_test_billing_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "setup_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_agent_card_validation_gate": { "get": { "summary": "Track Google Marketplace Agent Card Cloud Storage upload and Producer Portal validation evidence.", "operationId": "get_google_marketplace_agent_card_validation_gate", "x-mcp-tool": "google_marketplace_agent_card_validation_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Evaluate Agent Card validation readiness from supplied GCS URI and Producer Portal validation receipt.", "operationId": "post_google_marketplace_agent_card_validation_gate", "x-mcp-tool": "google_marketplace_agent_card_validation_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "product_metadata": { "type": "object" }, "setup_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_agent_card_gcs_pack": { "get": { "summary": "Return Google Marketplace Agent Card same-project Cloud Storage upload pack.", "operationId": "get_google_marketplace_agent_card_gcs_upload_pack", "x-mcp-tool": "google_marketplace_agent_card_gcs_upload_pack", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate Agent Card GCS upload commands and Producer Portal steps from supplied project and bucket metadata.", "operationId": "post_google_marketplace_agent_card_gcs_upload_pack", "x-mcp-tool": "google_marketplace_agent_card_gcs_upload_pack", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "product_metadata": { "type": "object" }, "setup_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_review_bundle": { "get": { "summary": "Return Google Marketplace Producer Portal and Partner Engineer review files.", "operationId": "get_google_marketplace_review_bundle", "x-mcp-tool": "google_marketplace_review_bundle", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate a review file bundle from supplied product, setup, and pricing metadata.", "operationId": "post_google_marketplace_review_bundle", "x-mcp-tool": "google_marketplace_review_bundle", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "product_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_review_index": { "get": { "summary": "Return the Google Marketplace review index entrypoint.", "operationId": "get_google_marketplace_review_index", "x-mcp-tool": "google_marketplace_review_index", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Map supplied product, setup, and pricing metadata to Google Marketplace review areas, files, commands, and evidence keys.", "operationId": "post_google_marketplace_review_index", "x-mcp-tool": "google_marketplace_review_index", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "product_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_core_source_map": { "get": { "summary": "Return the core technology source map for Google Marketplace review.", "operationId": "get_google_marketplace_core_technology_source_map", "x-mcp-tool": "google_marketplace_core_technology_source_map", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Return the core technology source map with supplied service URL context.", "operationId": "post_google_marketplace_core_technology_source_map", "x-mcp-tool": "google_marketplace_core_technology_source_map", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_application_status": { "get": { "summary": "Track Google Marketplace application evidence and review status.", "operationId": "get_google_marketplace_application_status", "x-mcp-tool": "google_marketplace_application_status", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Evaluate Google Marketplace application status from supplied external evidence.", "operationId": "post_google_marketplace_application_status", "x-mcp-tool": "google_marketplace_application_status", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "setup_metadata": { "type": "object" }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_application_evidence": { "get": { "summary": "Return persisted Google Marketplace application evidence and recomputed status.", "operationId": "get_google_marketplace_application_evidence", "x-mcp-tool": "google_marketplace_application_evidence", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Persist Google Marketplace application evidence and recompute status.", "operationId": "post_google_marketplace_application_evidence", "x-mcp-tool": "google_marketplace_application_evidence", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "setup_metadata": { "type": "object" }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_partner_application_gate": { "get": { "summary": "Track Google Partner, vendor, and Producer Portal access evidence before product configuration.", "operationId": "get_google_marketplace_partner_application_gate", "x-mcp-tool": "google_marketplace_partner_application_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Evaluate Partner / Producer Portal application readiness from supplied external evidence.", "operationId": "post_google_marketplace_partner_application_gate", "x-mcp-tool": "google_marketplace_partner_application_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "setup_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_operations_gate": { "get": { "summary": "Track Google Marketplace operational readiness for Producer Portal IAM, test billing, and App Lifecycle Manager.", "operationId": "get_google_marketplace_operations_gate", "x-mcp-tool": "google_marketplace_operations_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Evaluate Google Marketplace operations gate from supplied external setup evidence.", "operationId": "post_google_marketplace_operations_gate", "x-mcp-tool": "google_marketplace_operations_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "setup_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_ops_identity_gate": { "get": { "summary": "Track Google Marketplace IAM, service-account, restricted API, ALM, and usage identity evidence.", "operationId": "get_google_marketplace_ops_identity_gate", "x-mcp-tool": "google_marketplace_ops_identity_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Evaluate Google Marketplace ops identity evidence from supplied setup and pricing metadata.", "operationId": "post_google_marketplace_ops_identity_gate", "x-mcp-tool": "google_marketplace_ops_identity_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "setup_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_cloud_run_deployment_gate": { "get": { "summary": "Track Cloud Run runtime evidence before Google Marketplace technical review.", "operationId": "get_google_marketplace_cloud_run_deployment_gate", "x-mcp-tool": "google_marketplace_cloud_run_deployment_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Evaluate Cloud Run service URL, public Agent endpoints, service identity, deployment receipt, and Marketplace metadata token source evidence.", "operationId": "post_google_marketplace_cloud_run_deployment_gate", "x-mcp-tool": "google_marketplace_cloud_run_deployment_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "setup_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_live_surface_gate": { "get": { "summary": "Fetch and verify public Google Marketplace reviewer surfaces on the deployed Agent runtime.", "operationId": "get_google_marketplace_live_surface_gate", "x-mcp-tool": "google_marketplace_live_surface_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Run the live-surface gate against a supplied public HTTPS Agent runtime URL.", "operationId": "post_google_marketplace_live_surface_gate", "x-mcp-tool": "google_marketplace_live_surface_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_preflight": { "get": { "summary": "Run a strict Google Marketplace preflight across Agent Card, product reviews, technical integration, and operations gates.", "operationId": "get_google_marketplace_preflight_check", "x-mcp-tool": "google_marketplace_preflight_check", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Run Google Marketplace preflight from supplied product, pricing, and setup evidence.", "operationId": "post_google_marketplace_preflight_check", "x-mcp-tool": "google_marketplace_preflight_check", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "setup_metadata": { "type": "object" }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_publish_gate": { "get": { "summary": "Track Google Marketplace publish evidence before public availability claims.", "operationId": "get_google_marketplace_publish_gate", "x-mcp-tool": "google_marketplace_publish_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Evaluate publish readiness from supplied Producer Portal and Google operations evidence.", "operationId": "post_google_marketplace_publish_gate", "x-mcp-tool": "google_marketplace_publish_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "setup_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_review_receipt_gate": { "get": { "summary": "Track external Google and Producer Portal review receipts.", "operationId": "get_google_marketplace_review_receipt_gate", "x-mcp-tool": "google_marketplace_review_receipt_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Evaluate Google Marketplace review receipt readiness from supplied external evidence.", "operationId": "post_google_marketplace_review_receipt_gate", "x-mcp-tool": "google_marketplace_review_receipt_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "setup_metadata": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_evidence_template": { "get": { "summary": "Return a fillable Google Marketplace application evidence template.", "operationId": "get_google_marketplace_evidence_template", "x-mcp-tool": "google_marketplace_evidence_template", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_evidence_example": { "get": { "summary": "Return an example-only Google Marketplace evidence starter file.", "operationId": "get_google_marketplace_evidence_example", "x-mcp-tool": "google_marketplace_evidence_example", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_procurement_event": { "post": { "summary": "Normalize a Google Marketplace Pub/Sub procurement event and enqueue a non-executing action plan.", "operationId": "post_google_marketplace_procurement_event", "x-mcp-tool": "google_marketplace_procurement_event", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "procurement_event": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_procurement_state": { "get": { "summary": "Return local Google Marketplace procurement account, entitlement, and action-queue state.", "operationId": "get_google_marketplace_procurement_state", "x-mcp-tool": "google_marketplace_procurement_state", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_procurement_execute": { "post": { "summary": "Execute one explicit Google Partner Procurement API action with execute=true and credentials.", "operationId": "post_google_marketplace_procurement_execute", "x-mcp-tool": "google_marketplace_procurement_execute", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "action": { "type": "object" }, "execute": { "type": "boolean" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_usage_report_payload": { "get": { "summary": "Return a sample Google Service Control usage report payload.", "operationId": "get_google_marketplace_usage_report_payload", "x-mcp-tool": "google_marketplace_usage_report_payload", "parameters": [ { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Build a Service Control usage report payload from supplied entitlement and metric metadata.", "operationId": "post_google_marketplace_usage_report_payload", "x-mcp-tool": "google_marketplace_usage_report_payload", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_usage_report_execute": { "post": { "summary": "Execute Service Control services.check and services.report with execute=true and credentials.", "operationId": "post_google_marketplace_usage_report_execute", "x-mcp-tool": "google_marketplace_usage_report_execute", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "payload": { "type": "object" }, "execute": { "type": "boolean" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_frontend_integration": { "get": { "summary": "Return Google Marketplace frontend integration URLs and JWT requirements.", "operationId": "get_google_marketplace_frontend_integration", "x-mcp-tool": "google_marketplace_frontend_integration", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Return frontend integration readiness with supplied setup evidence.", "operationId": "post_google_marketplace_frontend_integration", "x-mcp-tool": "google_marketplace_frontend_integration", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_account_link": { "post": { "summary": "Validate Google Marketplace account-linking input and return a non-executing approval action plan.", "operationId": "post_google_marketplace_account_link", "x-mcp-tool": "google_marketplace_account_link", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "jwt": { "type": "string" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_marketplace_jwt_verifier_gate": { "get": { "summary": "Track Google Marketplace JWT verifier evidence.", "operationId": "get_google_marketplace_jwt_verifier_gate", "x-mcp-tool": "google_marketplace_jwt_verifier_gate", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Evaluate JWT verifier readiness from setup evidence and optional x-gcp-marketplace-token sample.", "operationId": "post_google_marketplace_jwt_verifier_gate", "x-mcp-tool": "google_marketplace_jwt_verifier_gate", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "setup_metadata": { "type": "object" }, "jwt": { "type": "string" }, "token_context": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/pricing": { "get": { "summary": "Return machine-readable AEO Agent pricing.", "operationId": "get_get_pricing", "x-mcp-tool": "get_pricing", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/billing_guide": { "get": { "summary": "Return the Agent-readable billing guide for free, paid, checkout, and x402-style job flows.", "operationId": "get_agent_billing_guide", "x-mcp-tool": "agent_billing_guide", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/billing/portal": { "post": { "summary": "Create a provider-hosted subscription management session for the authenticated website.", "operationId": "post_billing_portal", "x-mcp-tool": "billing_portal", "security": [ { "siteAgentKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/checkout": { "post": { "summary": "Create a checkout session for paid AEO Agent work.", "operationId": "post_agent_checkout", "x-mcp-tool": "agent_checkout", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plan": { "type": "string" } }, "required": [ "plan" ] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/self_audit": { "get": { "summary": "Audit this service's own Agent-first surfaces.", "operationId": "get_self_audit", "x-mcp-tool": "self_audit", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/self_backlog": { "get": { "summary": "Generate this service's monthly self-optimization backlog.", "operationId": "get_self_backlog", "x-mcp-tool": "self_backlog", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/self_optimize": { "post": { "summary": "Generate and store the current self-optimization backlog.", "operationId": "post_api_agent_self_optimize", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/.well-known/agentx-issuer-key.json": { "get": { "summary": "Return the AgentX.ID issuer proof verification descriptor.", "operationId": "get_well_known_agentx_issuer_key_json", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/passport": { "get": { "summary": "Return this service's AgentX.ID Passport.", "operationId": "get_agentx_passport", "x-mcp-tool": "agentx_passport", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/passport_status": { "get": { "summary": "Return the revocation-aware status document for an AgentX.ID Passport.", "operationId": "get_api_agent_passport_status", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/passport_verify": { "get": { "summary": "Verify this service's current AgentX.ID Passport issuer proof and return failure_codes, next_actions, and execution_policy when not ok.", "operationId": "get_agentx_passport_verify", "x-mcp-tool": "agentx_passport_verify", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Verify a supplied AgentX.ID Passport issuer proof, content hash, Agent ID, and revocation status; returns failure_codes, next_actions, and execution_policy.", "operationId": "post_agentx_passport_verify", "x-mcp-tool": "agentx_passport_verify", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/proof_graph": { "get": { "summary": "Return the evidence graph behind this service's Agent Passport.", "operationId": "get_proof_graph", "x-mcp-tool": "proof_graph", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/a1_reads": { "get": { "summary": "Summarize real AI crawler read events.", "operationId": "get_a1_ai_reads", "x-mcp-tool": "a1_ai_reads", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidenceSummaryResult" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Ingest HTTP/CDN log events for A1 AI read measurement.", "operationId": "post_a1_ai_reads", "x-mcp-tool": "a1_ai_reads", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "status": { "type": "string" } }, "required": [] } } } }, "responses": { "200": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidenceImportResult" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/a1_dashboard": { "get": { "summary": "Return A1 AI crawler read dashboard KPIs.", "operationId": "get_a1_ai_read_dashboard", "x-mcp-tool": "a1_ai_read_dashboard", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate A1 dashboard KPIs from HTTP/CDN log events.", "operationId": "post_a1_ai_read_dashboard", "x-mcp-tool": "a1_ai_read_dashboard", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "period": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/a1_read_package": { "get": { "summary": "Return a reviewable A1 AI crawler read evidence package.", "operationId": "get_a1_ai_read_evidence_package", "x-mcp-tool": "a1_ai_read_evidence_package", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate an A1 evidence package from HTTP/CDN log events.", "operationId": "post_a1_ai_read_evidence_package", "x-mcp-tool": "a1_ai_read_evidence_package", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "period": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/a2_citations": { "get": { "summary": "Summarize AI answer citation probes.", "operationId": "get_a2_ai_citations", "x-mcp-tool": "a2_ai_citations", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Ingest AI answer citation probes for A2 visibility measurement.", "operationId": "post_a2_ai_citations", "x-mcp-tool": "a2_ai_citations", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "competitors": { "type": "array", "items": { "type": "string" } } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/a2_citation_package": { "get": { "summary": "Return a reviewable A2 AI answer citation evidence package.", "operationId": "get_a2_ai_citation_evidence_package", "x-mcp-tool": "a2_ai_citation_evidence_package", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate an A2 evidence package from imported prompt-test probe results.", "operationId": "post_a2_ai_citation_evidence_package", "x-mcp-tool": "a2_ai_citation_evidence_package", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "events": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/a2_probe_sets": { "post": { "summary": "Create a stable buyer-question probe set and optional coverage report.", "operationId": "post_a2_probe_sets", "x-mcp-tool": "a2_probe_sets", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/a2_probe_run": { "post": { "summary": "Run a fixed A2 probe set against operator-approved answer engines after explicit billable opt-in.", "operationId": "post_api_agent_a2_probe_run", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/b1_conversions": { "get": { "summary": "Summarize AI-attributed conversion events.", "operationId": "get_b1_conversions", "x-mcp-tool": "b1_conversions", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidenceSummaryResult" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Ingest lead, RFQ, order, or CRM conversion events for B1 attribution.", "operationId": "post_b1_conversions", "x-mcp-tool": "b1_conversions", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "events": { "type": "array", "items": { "type": "object" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" } }, "required": [] } } } }, "responses": { "200": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidenceImportResult" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/b1_conversion_package": { "get": { "summary": "Return a reviewable B1 conversion evidence package.", "operationId": "get_b1_conversion_evidence_package", "x-mcp-tool": "b1_conversion_evidence_package", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate a B1 evidence package from imported conversion, CRM, lead, RFQ, or order events.", "operationId": "post_b1_conversion_evidence_package", "x-mcp-tool": "b1_conversion_evidence_package", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "events": { "type": "array", "items": { "type": "object" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "period": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/implementation_bundle": { "get": { "summary": "Return a reviewable F1 implementation bundle.", "operationId": "get_f1_implementation_bundle", "x-mcp-tool": "f1_implementation_bundle", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate an F1 implementation bundle from supplied audit evidence.", "operationId": "post_f1_implementation_bundle", "x-mcp-tool": "f1_implementation_bundle", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/audit_file_package": { "get": { "summary": "Return a reviewable A0 audit file package.", "operationId": "get_a0_audit_file_package", "x-mcp-tool": "a0_audit_file_package", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate one A0 handoff package from audit, content, implementation, and measurement artifacts.", "operationId": "post_a0_audit_file_package", "x-mcp-tool": "a0_audit_file_package", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/skill_package": { "get": { "summary": "Return an installable S1 Agent Skill package.", "operationId": "get_s1_skill_package", "x-mcp-tool": "s1_skill_package", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate an S1 Skill package for an external or verified website Agent.", "operationId": "post_s1_skill_package", "x-mcp-tool": "s1_skill_package", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/installation_verification": { "get": { "summary": "Verify deployed F1 files and snippets from audit evidence.", "operationId": "get_v1_installation_verification", "x-mcp-tool": "v1_installation_verification", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate a V1 installation verification from supplied audit evidence.", "operationId": "post_v1_installation_verification", "x-mcp-tool": "v1_installation_verification", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/content_optimization_plan": { "get": { "summary": "Return a C1 content citability optimization plan.", "operationId": "get_c1_content_optimization_plan", "x-mcp-tool": "c1_content_optimization_plan", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate C1 answer-first rewrites, schema guidance, citation gaps, and a 30-day plan.", "operationId": "post_c1_content_optimization_plan", "x-mcp-tool": "c1_content_optimization_plan", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/content_workflow_package": { "get": { "summary": "Return a C4 Agent-ready content workflow package.", "operationId": "get_c4_content_workflow_package", "x-mcp-tool": "c4_content_workflow_package", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate C4 deliverable files from C1/C2/C3 content workflow artifacts.", "operationId": "post_c4_content_workflow_package", "x-mcp-tool": "c4_content_workflow_package", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/content_pack": { "get": { "summary": "Return one Agent-ready Content Pack.", "operationId": "get_content_optimization_pack", "x-mcp-tool": "content_optimization_pack", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Bundle C1, C2, C4, and M8 content optimization outputs into one Agent-ready pack.", "operationId": "post_content_optimization_pack", "x-mcp-tool": "content_optimization_pack", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/content_workflow_review": { "post": { "summary": "Review a C4 workflow package or Content Pack for completeness, evidence boundaries, and fabricated-claim risk.", "operationId": "post_c5_content_workflow_review", "x-mcp-tool": "c5_content_workflow_review", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/content_publication_package": { "get": { "summary": "Return an M8 content publication evidence package.", "operationId": "get_m8_content_publication_evidence_package", "x-mcp-tool": "m8_content_publication_evidence_package", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate M8 publication evidence from C4 outputs, proof URLs, and optional strict HTTP proof verification.", "operationId": "post_m8_content_publication_evidence_package", "x-mcp-tool": "m8_content_publication_evidence_package", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/citation_gap_matrix": { "get": { "summary": "Return a C1 citation-gap matrix.", "operationId": "get_c1_citation_gap_matrix", "x-mcp-tool": "c1_citation_gap_matrix", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate C1 target-vs-competitor citation gaps without fabricated scores.", "operationId": "post_c1_citation_gap_matrix", "x-mcp-tool": "c1_citation_gap_matrix", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/community_citation_plan": { "get": { "summary": "Return a C1 white-hat community citation plan.", "operationId": "get_c1_community_citation_plan", "x-mcp-tool": "c1_community_citation_plan", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate C1 community citation targets, scripts, proof fields, and guardrails.", "operationId": "post_c1_community_citation_plan", "x-mcp-tool": "c1_community_citation_plan", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/prompt_test_run_sheet": { "get": { "summary": "Return a C2 manual AI prompt-test run sheet.", "operationId": "get_c2_prompt_test_run_sheet", "x-mcp-tool": "c2_prompt_test_run_sheet", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate a C2 prompt-test run sheet from C1 questions or supplied topics.", "operationId": "post_c2_prompt_test_run_sheet", "x-mcp-tool": "c2_prompt_test_run_sheet", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/prompt_test_results": { "post": { "summary": "Import completed C2 prompt-test rows into A2 citation evidence.", "operationId": "post_c3_prompt_test_results_import", "x-mcp-tool": "c3_prompt_test_results_import", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/evidence_pack": { "get": { "summary": "Return deterministic E1 audit evidence details.", "operationId": "get_e1_evidence_pack", "x-mcp-tool": "e1_evidence_pack", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Extract the E1 evidence pack from supplied or freshly fetched audit evidence.", "operationId": "post_e1_evidence_pack", "x-mcp-tool": "e1_evidence_pack", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/audit_report": { "get": { "summary": "Return a customer-readable R1 audit report.", "operationId": "get_r1_audit_report", "x-mcp-tool": "r1_audit_report", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuditReportResult" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate an R1 audit report from supplied audit evidence.", "operationId": "post_r1_audit_report", "x-mcp-tool": "r1_audit_report", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuditReportResult" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/g1_google_official": { "get": { "summary": "Summarize Google PageSpeed / Lighthouse official report evidence.", "operationId": "get_g1_google_official", "x-mcp-tool": "g1_google_official", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Ingest a Google PageSpeed / Lighthouse result for G1 official evidence.", "operationId": "post_g1_google_official", "x-mcp-tool": "g1_google_official", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/g2_google_delta": { "get": { "summary": "Compare stored Google official snapshots for before-after movement.", "operationId": "get_g2_google_delta", "x-mcp-tool": "g2_google_delta", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Ingest before-after Google official snapshots and return a delta report.", "operationId": "post_g2_google_delta", "x-mcp-tool": "g2_google_delta", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "before": { "type": "object" }, "after": { "type": "object" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/g3_google_verification_plan": { "get": { "summary": "Return a strict Google PageSpeed / Lighthouse rerun plan.", "operationId": "get_g3_google_verification_plan", "x-mcp-tool": "g3_google_verification_plan", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/outcome_report": { "get": { "summary": "Return a combined measurable AEO outcome report.", "operationId": "get_m1_outcome_report", "x-mcp-tool": "m1_outcome_report", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/outcome_package": { "get": { "summary": "Return a reviewable M1 outcome evidence package.", "operationId": "get_m1_outcome_evidence_package", "x-mcp-tool": "m1_outcome_evidence_package", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/monthly_package": { "get": { "summary": "Return a reviewable M2 monthly optimization package.", "operationId": "get_m2_monthly_optimization_package", "x-mcp-tool": "m2_monthly_optimization_package", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/monthly_tracker": { "get": { "summary": "Return an M3 monthly execution tracker.", "operationId": "get_m3_monthly_execution_tracker", "x-mcp-tool": "m3_monthly_execution_tracker", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate an M3 execution workboard from supplied or stored monthly evidence.", "operationId": "post_m3_monthly_execution_tracker", "x-mcp-tool": "m3_monthly_execution_tracker", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/monthly_scorecard": { "get": { "summary": "Return an M4 monthly outcome scorecard.", "operationId": "get_m4_monthly_outcome_scorecard", "x-mcp-tool": "m4_monthly_outcome_scorecard", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate an M4 scorecard separating reportable evidence from claim limits.", "operationId": "post_m4_monthly_outcome_scorecard", "x-mcp-tool": "m4_monthly_outcome_scorecard", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/monthly_dashboard": { "get": { "summary": "Return an M5 monthly dashboard.", "operationId": "get_m5_monthly_dashboard", "x-mcp-tool": "m5_monthly_dashboard", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate an M5 dashboard with KPI cards, proof levels, and next actions.", "operationId": "post_m5_monthly_dashboard", "x-mcp-tool": "m5_monthly_dashboard", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/agent/dashboard": { "get": { "summary": "Render the M5 monthly dashboard as a shareable HTML page.", "operationId": "get_m6_shareable_dashboard_page", "x-mcp-tool": "m6_shareable_dashboard_page", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/measurement_contract": { "get": { "summary": "Return the stable customer performance metric and claim-boundary contract.", "operationId": "get_api_agent_measurement_contract", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/measurement_snapshots": { "get": { "summary": "List authenticated tenant measurement snapshots.", "operationId": "get_api_agent_measurement_snapshots", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Create an authenticated tenant measurement snapshot.", "operationId": "post_api_agent_measurement_snapshots", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/evidence_export": { "get": { "summary": "Export authenticated tenant evidence with deterministic digests and secret redaction.", "operationId": "get_api_agent_evidence_export", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/measurement_comparison": { "get": { "summary": "Compare the authenticated tenant's two latest snapshots.", "operationId": "get_api_agent_measurement_comparison", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/measurement_report": { "get": { "summary": "Render the authenticated tenant's latest evidence-backed performance report.", "operationId": "get_api_agent_measurement_report", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/identity_rails": { "get": { "summary": "Read the authenticated tenant's private identity-rail receipts.", "operationId": "get_api_agent_identity_rails", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/identity_rails/public": { "get": { "summary": "Read a public hash-only identity-rail projection without private Google or wallet fields.", "operationId": "get_api_agent_identity_rails_public", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/identity_rails/erc8004/plan": { "post": { "summary": "Create and persist an unsigned ERC-8004 Identity Registry registration plan; no chain write is performed.", "operationId": "post_api_agent_identity_rails_erc8004_plan", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/identity_rails/measurement": { "post": { "summary": "Persist an A1-A4 evidence receipt from the server's existing decision-intelligence snapshot.", "operationId": "post_api_agent_identity_rails_measurement", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/optimization_cycle": { "get": { "summary": "Return the O1 continuous AEO optimization cycle.", "operationId": "get_o1_optimization_cycle", "x-mcp-tool": "o1_optimization_cycle", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate an O1 optimization cycle from supplied audit evidence.", "operationId": "post_o1_optimization_cycle", "x-mcp-tool": "o1_optimization_cycle", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/insights": { "get": { "summary": "Generate evidence-backed AEO optimization insights.", "operationId": "get_i1_insights", "x-mcp-tool": "i1_insights", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Generate evidence-backed AEO optimization insights from supplied evidence.", "operationId": "post_i1_insights", "x-mcp-tool": "i1_insights", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/insights/job_drafts": { "post": { "summary": "Turn I1 optimization insights into scoped AEO job drafts.", "operationId": "post_i1_job_drafts", "x-mcp-tool": "i1_job_drafts", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_alignment": { "get": { "summary": "Return the Google Cloud Enterprise Agent Platform alignment brief.", "operationId": "get_google_cloud_alignment", "x-mcp-tool": "google_cloud_alignment", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/google_identity_bridge": { "get": { "summary": "Return the Google Agent Identity onboarding and identity-layer contract without side effects.", "operationId": "get_google_agent_identity_bridge", "x-mcp-tool": "google_agent_identity_bridge", "parameters": [ { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Validate a submitted Google effectiveIdentity binding candidate; authenticated Google API refetch remains required before binding.", "operationId": "post_google_agent_identity_bridge", "x-mcp-tool": "google_agent_identity_bridge", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "twin3_agent_id": { "type": "string" }, "evidence": { "type": "object" } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/trust_stack": { "get": { "summary": "Return the AgentX.ID trust and commerce architecture plan.", "operationId": "get_trust_commerce_stack", "x-mcp-tool": "trust_commerce_stack", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/job_drafts": { "post": { "summary": "Turn audit gaps into scoped AEO job drafts.", "operationId": "post_aeo_job_drafts", "x-mcp-tool": "aeo_job_drafts", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/job_drafts/accept": { "post": { "summary": "Accept a job draft into the AEO job ledger without funding it.", "operationId": "post_aeo_job_accept_draft", "x-mcp-tool": "aeo_job_accept_draft", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/jobs": { "get": { "summary": "List redacted AEO job escrow records.", "operationId": "get_api_agent_jobs", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/jobs/create": { "post": { "summary": "Create an ERC-8183-style AEO delivery job.", "operationId": "post_aeo_job_create", "x-mcp-tool": "aeo_job_create", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "job_type": { "type": "string" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "currency": { "type": "string" } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/jobs/fund": { "post": { "summary": "Mark an AEO delivery job as funded.", "operationId": "post_aeo_job_fund", "x-mcp-tool": "aeo_job_fund", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "job_id": { "type": "string" }, "payment_reference": { "type": "string" } }, "required": [ "job_id" ] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/jobs/payment_quote": { "post": { "summary": "Return an x402-style payment requirement for an open AEO delivery job.", "operationId": "post_aeo_job_payment_quote", "x-mcp-tool": "aeo_job_payment_quote", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "job_id": { "type": "string" } }, "required": [ "job_id" ] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/jobs/fund_with_proof": { "post": { "summary": "Mark an AEO delivery job as funded from a redacted payment proof.", "operationId": "post_aeo_job_payment_proof", "x-mcp-tool": "aeo_job_payment_proof", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "job_id": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" } }, "required": [ "job_id" ] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/jobs/submit": { "post": { "summary": "Submit an AEO delivery job with a deliverable hash.", "operationId": "post_aeo_job_submit", "x-mcp-tool": "aeo_job_submit", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "job_id": { "type": "string" }, "provider": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" } }, "required": [ "job_id" ] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/jobs/evaluate": { "post": { "summary": "Complete or reject an AEO delivery job with evaluator attestation.", "operationId": "post_aeo_job_evaluate", "x-mcp-tool": "aeo_job_evaluate", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "job_id": { "type": "string" }, "evaluator": { "type": "string" }, "decision": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "job_id" ] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/agentx/id/{agent_id}.json": { "get": { "summary": "Resolve a public, domain-bound Agent identity Passport as JSON.", "operationId": "get_agentx_id_agent_id_json", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/agentx/id/{agent_id}/status.json": { "get": { "summary": "Resolve current identity and credential status, including rotation or revocation.", "operationId": "get_agentx_id_agent_id_status_json", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/agentx/id/{agent_id}/proof.json": { "get": { "summary": "Resolve the current evidence graph for a domain-bound Agent identity.", "operationId": "get_agentx_id_agent_id_proof_json", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/sdk_event": { "post": { "summary": "Receive a small Site SDK heartbeat event.", "operationId": "post_api_agent_sdk_event", "responses": { "200": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SdkEventResult" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/agent/health.json": { "get": { "summary": "Return this service's Agent-first health state.", "operationId": "get_get_health", "x-mcp-tool": "get_health", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/audit": { "post": { "summary": "External agent calls twin3 to audit a website.", "operationId": "post_audit_url", "x-mcp-tool": "audit_url", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuditCallResult" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/industry_taxonomy": { "get": { "summary": "Return the canonical 12-industry taxonomy and buyer/conversion goals.", "operationId": "get_industry_taxonomy", "x-mcp-tool": "industry_taxonomy", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/p2_parity_inspect": { "post": { "summary": "Run one canonical domain-bound parity inspection.", "x-auth": "Site Agent Key issued after exact domain ownership verification.", "operationId": "post_p2_parity_inspect", "x-mcp-tool": "p2_parity_inspect", "security": [ { "siteAgentKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/gtmc/customer_dashboard": { "post": { "summary": "Return the GTMC customer view over canonical Agent ID evidence.", "x-auth": "Site Agent Key issued after exact domain ownership verification.", "operationId": "post_gtmc_customer_dashboard", "x-mcp-tool": "gtmc_customer_dashboard", "security": [ { "siteAgentKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/checkout/session": { "post": { "summary": "Create a provider checkout session bound to one verified website.", "x-auth": "Site Agent Key issued after exact domain ownership verification.", "operationId": "post_checkout_session", "x-mcp-tool": "checkout_session", "security": [ { "siteAgentKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/checkout/status": { "get": { "summary": "Read provider-confirmed entitlements for the authenticated website.", "x-auth": "Site Agent Key issued after exact domain ownership verification.", "operationId": "get_checkout_status", "x-mcp-tool": "checkout_status", "security": [ { "siteAgentKey": [] } ], "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/readiness_snapshot": { "get": { "summary": "Fetch a website audit and freeze its public evidence into a deterministic snapshot.", "operationId": "get_readiness_snapshot", "x-mcp-tool": "readiness_snapshot", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Freeze supplied audit evidence into a hash-addressed readiness snapshot.", "operationId": "post_readiness_snapshot", "x-mcp-tool": "readiness_snapshot", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/readiness_compare": { "post": { "summary": "Compare two readiness snapshots by dimension and check without claiming causality.", "operationId": "post_readiness_compare", "x-mcp-tool": "readiness_compare", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/pilot_report": { "get": { "summary": "Retrieve a stored Pilot evidence report by pilot_id.", "operationId": "get_pilot_report", "x-mcp-tool": "pilot_report", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Create and store a baseline-to-recheck Pilot report with A1, A2, and B1 evidence boundaries.", "operationId": "post_pilot_report", "x-mcp-tool": "pilot_report", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/agent/pilot/program": { "get": { "summary": "Read the authenticated website Pilot state and aggregate exit gate.", "operationId": "get_pilot_program", "x-mcp-tool": "pilot_program", "security": [ { "siteAgentKey": [] } ], "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Enroll a verified website or record an integrity-checked monthly Pilot cycle.", "x-auth": "Site Agent Key issued after exact domain ownership verification.", "operationId": "post_pilot_program", "x-mcp-tool": "pilot_program", "security": [ { "siteAgentKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/install_guide": { "get": { "summary": "Return the public no-side-effect Site Agent installation guide.", "operationId": "get_site_agent_install_guide", "x-mcp-tool": "site_agent_install_guide", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SiteAgentInstallGuide" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/.well-known/xagent-install.json": { "get": { "summary": "Return the compact machine-executable xAgent installation manifest.", "operationId": "get_well_known_xagent_install_json", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/register": { "post": { "summary": "Register a website and return a domain ownership challenge.", "operationId": "post_register_site_agent", "x-mcp-tool": "register_site_agent", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "email": { "type": "string" } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SiteAgentRegistration" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/install_status": { "get": { "summary": "Return a key-free public installation and domain-proof status.", "operationId": "get_api_site_agents_install_status", "responses": { "200": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SiteAgentInstallStatus" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/permissions": { "get": { "summary": "Read the authenticated website's five-module grant.", "x-auth": "Site Agent Key", "x-tenant-bound": true, "operationId": "get_api_site_agents_permissions", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Replace the authenticated website's module grant using least privilege.", "x-auth": "Site Agent Key", "x-tenant-bound": true, "operationId": "post_api_site_agents_permissions", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/v1/dashboard/pairings": { "post": { "summary": "Create a one-time customer Dashboard login URL.", "x-auth": "Enterprise access token with insights:read scope.", "x-tenant-bound": true, "x-secret-policy": "The browser never receives the enterprise key or bootstrap secret.", "operationId": "post_api_site_agents_v1_dashboard_pairings", "responses": { "201": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DashboardPairing" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/dashboard/session": { "get": { "summary": "Resolve the current short-lived, read-only Dashboard session.", "operationId": "get_api_dashboard_session", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/dashboard/sites": { "get": { "summary": "List only sites linked to the authenticated Dashboard account.", "operationId": "get_api_dashboard_sites", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/dashboard/data": { "get": { "summary": "Return redacted evidence for one site in the authenticated Dashboard account.", "operationId": "get_api_dashboard_data", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/dashboard/connectors": { "get": { "summary": "Return redacted A1, A2, and B1 connector status for one authorized Dashboard site.", "operationId": "get_api_dashboard_connectors", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/dashboard/decision": { "get": { "summary": "Return tenant-private A0-A5 and B1 decision evidence for one authorized Dashboard site.", "x-auth": "Short-lived Dashboard session bound to the exact account and host.", "x-tenant-bound": true, "operationId": "get_api_dashboard_decision", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/dashboard/history": { "get": { "summary": "Return date-filtered, evidence-preserving trends for one authorized site.", "operationId": "get_api_dashboard_history", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/dashboard/export": { "get": { "summary": "Download the authorized site's filtered evidence as CSV or JSON.", "operationId": "get_api_dashboard_export", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/dashboard/logout": { "post": { "summary": "Revoke the current Dashboard session.", "operationId": "post_api_dashboard_logout", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/actions": { "get": { "summary": "Return the machine-readable Site Agent action catalog.", "operationId": "get_site_agent_actions", "x-mcp-tool": "site_agent_actions", "responses": { "200": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SiteAgentActionCatalog" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/v1/managed/subscription": { "get": { "summary": "Read the authenticated website's hosted monthly inspection subscription.", "x-auth": "Enterprise access token with insights:read scope.", "x-tenant-bound": true, "operationId": "get_managed_inspection_subscription", "x-mcp-tool": "managed_inspection_subscription", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Enable the authenticated website's hosted monthly public inspection.", "x-auth": "Enterprise access token with managed:write scope.", "x-tenant-bound": true, "x-access": "public_read_only", "x-mutation-authority": "none", "operationId": "post_managed_inspection_subscription", "x-mcp-tool": "managed_inspection_subscription", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "target_url": { "type": "string" }, "intent": { "type": "string" }, "evidence": { "type": "object" }, "public_metadata": { "type": "object" }, "setup_metadata": { "type": "object" }, "submission": { "type": "object" }, "platform_id": { "type": "string" }, "status": { "type": "string" }, "listing_url": { "type": "string" }, "platform_receipt_id": { "type": "string" }, "proof_url": { "type": "string" }, "jwt": { "type": "string" }, "token_context": { "type": "object" }, "claims": { "type": "object" }, "signature_verified": { "type": "boolean" }, "expected_audience": { "type": "string" }, "expected_email": { "type": "string" }, "evidence_type": { "type": "string" }, "certs": { "type": "object" }, "execution": { "type": "object" }, "store": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "user_agent": { "type": "string" }, "probes": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "prompt": { "type": "string" }, "answer": { "type": "string" }, "citations": { "type": "array", "items": {} }, "engine": { "type": "string" }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "event": { "type": "string" }, "referrer": { "type": "string" }, "survey_source": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "fetch": { "type": "boolean" }, "report": { "type": "object" }, "reports": { "type": "array", "items": { "type": "object" } }, "result": { "type": "object" }, "results": { "type": "array", "items": { "type": "object" } }, "product_metadata": { "type": "object" }, "pricing_metadata": { "type": "object" }, "receipt": { "type": "object" }, "receipts": { "type": "array", "items": { "type": "object" } }, "before": { "type": "object" }, "after": { "type": "object" }, "audit": { "type": "object" }, "content": { "type": "string" }, "page": { "type": "object" }, "questions": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "period": { "type": "object" }, "verify_artifacts": { "type": "boolean" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "verify_publication": { "type": "boolean" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } }, "insights": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "budget": { "type": "number" }, "draft": { "type": "object" }, "create_payload": { "type": "object" }, "job_type": { "type": "string" }, "job_id": { "type": "string" }, "payment_reference": { "type": "string" }, "payment_proof": { "type": "object" }, "payment_signature": { "type": "string" }, "deliverable_uri": { "type": "string" }, "deliverable": { "type": "object" }, "decision": { "type": "string" }, "reason": { "type": "string" }, "plan": { "type": "string" }, "email": { "type": "string" }, "method": { "type": "string" }, "procurement_event": { "type": "object" }, "action": { "type": "object" }, "execute": { "type": "boolean" }, "access_token": { "type": "string" }, "token_source": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "metadata_base": { "type": "string" }, "service_name": { "type": "string" }, "usage_reporting_id": { "type": "string" }, "metric_name": { "type": "string" }, "metric_value": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "operation_id": { "type": "string" }, "user_labels": { "type": "object" }, "payload": { "type": "object" }, "provider_id": { "type": "string" }, "account_id": { "type": "string" }, "entitlement_id": { "type": "string" }, "twin3_agent_id": { "type": "string" }, "pricing_model": { "type": "string", "enum": [ "free", "subscription", "usage", "combined", "subscription_plus_usage" ] } }, "required": [] } } } }, "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/v1/managed/subscription/pause": { "post": { "summary": "Pause the authenticated website's hosted inspection with optimistic version control.", "x-auth": "Enterprise access token with managed:write scope.", "x-tenant-bound": true, "operationId": "post_api_site_agents_v1_managed_subscription_pause", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/v1/managed/subscription/resume": { "post": { "summary": "Resume the authenticated website's hosted inspection with optimistic version control.", "x-auth": "Enterprise access token with managed:write scope.", "x-tenant-bound": true, "operationId": "post_api_site_agents_v1_managed_subscription_resume", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/v1/managed/runs": { "get": { "summary": "List the authenticated website's redacted managed-inspection results.", "x-auth": "Enterprise access token with insights:read scope.", "x-tenant-bound": true, "x-mutation-authority": "none", "operationId": "get_managed_inspection_runs", "x-mcp-tool": "managed_inspection_runs", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "listing_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "platform_receipt_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "proof_url", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jwt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "signature_verified", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "expected_audience", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "expected_email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "store", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "prompt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "answer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engine", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "engines", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "referrer", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "survey_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fetch", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topics", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cadence", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verify_artifacts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "verify_publication", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evaluator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "job_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_signature", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deliverable_uri", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "decision", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "execute", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "access_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "token_source", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metadata_base", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "service_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "usage_reporting_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "metric_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operation_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entitlement_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "twin3_agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pricing_model", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/v1/decision": { "get": { "summary": "Read tenant-private A0-A5 and B1 decision intelligence with replayable provenance and sample gates.", "x-auth": "Enterprise access token with insights:read scope.", "x-tenant-bound": true, "x-missing-data-policy": "unknown_not_zero", "x-claim-limit": "No ranking, citation, conversion, revenue, incrementality, or causality guarantee.", "operationId": "get_api_site_agents_v1_decision", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/v1/decision/observations": { "post": { "summary": "Append typed server-observed or customer-authorized decision evidence and recompute the tenant snapshot.", "x-auth": "Enterprise access token with evidence:write scope.", "x-tenant-bound": true, "x-evidence-kinds": [ "public_audit", "connector", "provider_decision" ], "x-secret-policy": "Raw model answers, credentials, and arbitrary private fields are rejected or reduced to hashes.", "operationId": "post_api_site_agents_v1_decision_observations", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/internal/managed-inspections/run": { "post": { "summary": "Claim due subscriptions and execute bounded public-read-only inspections.", "x-auth": "Google service-account OIDC token with exact audience and email binding.", "x-access": "internal_scheduler_only", "x-mutation-authority": "none", "operationId": "post_api_internal_managed_inspections_run", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/v1/tasks": { "get": { "summary": "List the authenticated website's tenant-bound optimization tasks.", "x-auth": "Enterprise access token with tasks:read scope.", "x-tenant-bound": true, "operationId": "get_api_site_agents_v1_tasks", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Issue one signed draft for a customer-approved allowlisted public artifact.", "x-auth": "Enterprise access token with tasks:execute scope.", "x-tenant-bound": true, "x-mutation-authority": "customer_local_policy_only", "x-allowlist": [ "llms.txt", ".well-known/agent-card.json", ".well-known/agent-id.json", ".well-known/aeo-agent.json", ".well-known/agent-knowledge.json" ], "x-review-only": [ "robots.txt" ], "operationId": "post_api_site_agents_v1_tasks", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/v1/tasks/{task_id}": { "get": { "summary": "Read one authenticated website's tenant-bound optimization task.", "x-auth": "Enterprise access token with tasks:read scope.", "x-tenant-bound": true, "operationId": "get_api_site_agents_v1_tasks_task_id", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/v1/tasks/{task_id}/rollback-receipt": { "post": { "summary": "Submit a customer-signed rollback receipt after restoring an approved task.", "x-auth": "Enterprise access token with evidence:write scope.", "x-tenant-bound": true, "x-requires": "rollback_pending", "x-mutation-authority": "customer_site_agent_only", "operationId": "post_api_site_agents_v1_tasks_task_id_rollback_receipt", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/v1/tasks/{task_id}/delegation": { "get": { "summary": "Return a signed, bounded delegation claim for an authenticated enterprise task.", "x-auth": "Enterprise access token with tasks:read scope.", "operationId": "get_api_site_agents_v1_tasks_task_id_delegation", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/v1/tasks/{task_id}/comparison": { "get": { "summary": "Return the signed whole-site before/after readiness receipt for a completed task.", "x-auth": "Enterprise access token with tasks:read scope.", "x-tenant-bound": true, "operationId": "get_api_site_agents_v1_tasks_task_id_comparison", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } }, "post": { "summary": "Re-audit the public site and create an idempotent signed comparison receipt from a pre-task managed-inspection baseline.", "x-auth": "Enterprise access token with tasks:read scope.", "x-mutation-authority": "none", "x-claim-limit": "Score changes do not prove AI ranking, citation, conversion, revenue, incrementality, or causality.", "operationId": "post_api_site_agents_v1_tasks_task_id_comparison", "responses": { "200": { "description": "Result envelope. Evidence-bearing responses carry explicit non_claims.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/verify_domain": { "post": { "summary": "Verify domain ownership and issue the Site Agent Key.", "operationId": "post_verify_domain_ownership", "x-mcp-tool": "verify_domain_ownership", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "method": { "type": "string" } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DomainVerificationResult" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/key_recovery/start": { "post": { "summary": "Start short-lived Site Agent Key recovery with a fresh DNS TXT challenge.", "x-rate-limit": "strict_per_ip", "x-secret-policy": "The one-time private recovery capability is returned once and stored only as a digest.", "operationId": "post_start_site_agent_key_recovery", "x-mcp-tool": "start_site_agent_key_recovery", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" } }, "required": [ "url" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SiteKeyRecoveryChallenge" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/key_recovery/complete": { "post": { "summary": "Replace a lost Site Agent Key after fresh DNS proof and private capability verification.", "x-auth": "Fresh DNS TXT plus one-time private recovery capability.", "x-secret-policy": "The replacement key is returned once; only its digest is stored.", "x-session-effect": "All earlier Site Agent Keys, Dashboard sessions, and OAuth tokens are invalidated by credential generation.", "operationId": "post_complete_site_agent_key_recovery", "x-mcp-tool": "complete_site_agent_key_recovery", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "challenge_id": { "type": "string" }, "recovery_capability": { "type": "string", "writeOnly": true } }, "required": [ "url", "challenge_id", "recovery_capability" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SiteKeyLifecycleResult" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/key_rotate": { "post": { "summary": "Rotate the authenticated website's Site Agent Key.", "x-auth": "Current Site Agent Key plus explicit approval.", "x-secret-policy": "The replacement key is returned once; only its digest is stored.", "x-session-effect": "Dependent Dashboard sessions and OAuth tokens are invalidated.", "operationId": "post_api_site_agents_key_rotate", "responses": { "201": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SiteKeyLifecycleResult" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/verify": { "post": { "summary": "Verify a Site Agent Key belongs to a URL.", "operationId": "post_api_site_agents_verify", "responses": { "200": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SiteAgentKeyVerification" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } }, "/api/site_agents/call": { "post": { "summary": "Website agent calls twin3 with its Site Agent Key.", "x-site-agent-tools": [ "site_agent_actions", "site_agent_call", "site_agent_insights", "site_agent_outcome_report", "site_agent_optimization_cycle", "site_agent_install_descriptor", "site_agent_implementation_bundle", "site_agent_audit_file_package", "site_agent_skill_package", "site_agent_installation_verification", "site_agent_content_optimization_plan", "site_agent_content_workflow_package", "site_agent_content_repair_pack", "site_agent_content_pack", "site_agent_content_publication_package", "site_agent_a1_read_evidence_package", "site_agent_a1_dashboard", "site_agent_site_signal_package", "site_agent_a2_citation_evidence_package", "site_agent_b1_conversion_evidence_package", "site_agent_m1_outcome_evidence_package", "site_agent_m2_monthly_optimization_package", "site_agent_m3_monthly_execution_tracker", "site_agent_m4_monthly_outcome_scorecard", "site_agent_m5_monthly_dashboard", "site_agent_monthly_evidence_loop", "site_agent_insights_feed", "site_agent_refresh_insight_inbox", "site_agent_insight_inbox", "site_agent_acknowledge_insight", "site_agent_apply_plan", "site_agent_apply_evidence", "site_agent_citation_gap_matrix", "site_agent_community_citation_plan", "site_agent_prompt_test_run_sheet", "site_agent_prompt_test_results_import", "site_agent_job_drafts", "site_agent_accept_job_draft", "site_agent_decide_job_draft", "site_agent_draft_decisions", "site_agent_decision_reviews", "site_agent_jobs", "site_agent_c5_repair_history", "site_agent_report_job_evidence" ], "x-auth": "Site Agent Key issued after domain ownership verification.", "operationId": "post_api_site_agents_call", "x-mcp-tools": [ "site_agent_install_descriptor", "site_agent_implementation_bundle", "site_agent_audit_file_package", "site_agent_skill_package", "site_agent_installation_verification", "site_agent_content_optimization_plan", "site_agent_content_workflow_package", "site_agent_content_repair_pack", "site_agent_content_pack", "site_agent_content_publication_package", "site_agent_a1_read_evidence_package", "site_agent_a1_dashboard", "site_agent_site_signal_package", "site_agent_a2_citation_evidence_package", "site_agent_b1_conversion_evidence_package", "site_agent_m1_outcome_evidence_package", "site_agent_m2_monthly_optimization_package", "site_agent_m3_monthly_execution_tracker", "site_agent_m4_monthly_outcome_scorecard", "site_agent_m5_monthly_dashboard", "site_agent_monthly_evidence_loop", "site_agent_insights_feed", "site_agent_refresh_insight_inbox", "site_agent_insight_inbox", "site_agent_acknowledge_insight", "site_agent_apply_plan", "site_agent_apply_evidence", "site_agent_citation_gap_matrix", "site_agent_community_citation_plan", "site_agent_prompt_test_run_sheet", "site_agent_prompt_test_results_import", "site_agent_insights", "site_agent_outcome_report", "site_agent_optimization_cycle", "site_agent_job_drafts", "site_agent_accept_job_draft", "site_agent_decide_job_draft", "site_agent_draft_decisions", "site_agent_decision_reviews", "site_agent_jobs", "site_agent_c5_repair_history", "site_agent_report_job_evidence", "site_agent_call" ], "security": [ { "siteAgentKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "install_descriptor" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "implementation_bundle" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "audit_file_package" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" }, "page": { "type": "object" }, "content": { "type": "string" }, "text": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "competitors": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "skill_package" }, "mode": { "type": "object" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "installation_verification" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "content_optimization_plan" }, "page": { "type": "object" }, "content": { "type": "string" }, "text": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "competitors": { "type": "array", "items": { "type": "string" } }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "content_workflow_package" }, "page": { "type": "object" }, "content": { "type": "string" }, "text": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "competitors": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "content_repair_pack" }, "review_gate": { "type": "object" }, "c5_repair_history": { "type": "object" }, "history": { "type": "object" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "page": { "type": "object" }, "content": { "type": "string" }, "text": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "competitors": { "type": "array", "items": { "type": "string" } }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "content_pack" }, "page": { "type": "object" }, "content": { "type": "string" }, "text": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "competitors": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" }, "content_plan": { "type": "object" }, "plan": { "type": "string" }, "content_workflow_package": { "type": "object" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "evidence": { "type": "object" }, "verify_publication": { "type": "boolean" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "content_publication_package" }, "content_workflow_package": { "type": "object" }, "package": { "type": "object" }, "published_items": { "type": "array", "items": { "type": "object" } }, "items": { "type": "array", "items": { "type": "object" } }, "evidence": { "type": "object" }, "page": { "type": "object" }, "content": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "competitors": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "a1_read_evidence_package" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "source": { "type": "string" }, "period": { "type": "object" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "a1_dashboard" }, "events": { "type": "array", "items": { "type": "object" } }, "logs": { "type": "array", "items": { "type": "object" } }, "source": { "type": "string" }, "period": { "type": "object" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "site_signal_package" }, "events": { "type": "array", "items": { "type": "object" } }, "sdk_events": { "type": "array", "items": { "type": "object" } }, "period": { "type": "object" }, "source": { "type": "string" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "a2_citation_evidence_package" }, "probes": { "type": "array", "items": { "type": "object" } }, "events": { "type": "array", "items": { "type": "object" } }, "probe_set": { "type": "object" }, "period": { "type": "object" }, "source": { "type": "string" }, "verify_artifacts": { "type": "boolean" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "b1_conversion_evidence_package" }, "events": { "type": "array", "items": { "type": "object" } }, "conversions": { "type": "array", "items": { "type": "object" } }, "period": { "type": "object" }, "source": { "type": "string" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "m1_outcome_evidence_package" }, "period": { "type": "object" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "m2_monthly_optimization_package" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" }, "period": { "type": "object" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "m3_monthly_execution_tracker" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" }, "period": { "type": "object" }, "page": { "type": "object" }, "content": { "type": "string" }, "text": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "competitors": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "m4_monthly_outcome_scorecard" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" }, "period": { "type": "object" }, "page": { "type": "object" }, "content": { "type": "string" }, "text": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "competitors": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "m5_monthly_dashboard" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" }, "period": { "type": "object" }, "page": { "type": "object" }, "content": { "type": "string" }, "text": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "competitors": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "monthly_evidence_loop" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" }, "period": { "type": "object" }, "page": { "type": "object" }, "content": { "type": "string" }, "text": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "competitors": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "content_pack": { "type": "object" }, "pack": { "type": "object" }, "content_publication_package": { "type": "object" }, "a2_citation_package": { "type": "object" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "insights_feed" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" }, "period": { "type": "object" }, "page": { "type": "object" }, "content": { "type": "string" }, "text": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "competitors": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "content_publication_package": { "type": "object" }, "a2_citation_package": { "type": "object" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "refresh_insight_inbox" }, "feed": { "type": "object" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" }, "period": { "type": "object" }, "page": { "type": "object" }, "content": { "type": "string" }, "text": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "competitors": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "content_publication_package": { "type": "object" }, "a2_citation_package": { "type": "object" }, "events": { "type": "array", "items": { "type": "object" } }, "sdk_events": { "type": "array", "items": { "type": "object" } } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "insight_inbox" }, "include_acknowledged": { "type": "object" }, "include_all": { "type": "object" }, "status": { "type": "string" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "acknowledge_insight" }, "item_id": { "type": "string" }, "status": { "type": "string" }, "decision": { "type": "string" } }, "required": [ "url", "action", "item_id" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "apply_plan" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" }, "period": { "type": "object" }, "page": { "type": "object" }, "content": { "type": "string" }, "text": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "competitors": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "market": { "type": "string" }, "cadence": { "type": "string" }, "content_publication_package": { "type": "object" }, "a2_citation_package": { "type": "object" }, "feed": { "type": "object" }, "delivery_targets": { "type": "array", "items": { "type": "object" } } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "apply_evidence" }, "apply_item_id": { "type": "string" }, "apply_item": { "type": "object" }, "apply_plan": { "type": "object" }, "job_id": { "type": "string" }, "evidence_uri": { "type": "string" }, "proof_url": { "type": "string" }, "pull_request_url": { "type": "string" }, "deployment_reference": { "type": "string" }, "evidence": { "type": "object" }, "source_feed_hash": { "type": "string" }, "verify_proof": { "type": "boolean" }, "verify": { "type": "boolean" } }, "required": [ "url", "action", "apply_item_id" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "citation_gap_matrix" }, "page": { "type": "object" }, "content": { "type": "string" }, "text": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "competitors": { "type": "array", "items": { "type": "string" } }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "community_citation_plan" }, "page": { "type": "object" }, "content": { "type": "string" }, "text": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "competitors": { "type": "array", "items": { "type": "string" } }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "prompt_test_run_sheet" }, "content_plan": { "type": "object" }, "plan": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } }, "topics": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "engines": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "competitors": { "type": "array", "items": { "type": "string" } }, "market": { "type": "string" }, "cadence": { "type": "string" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "prompt_test_results" }, "sheet": { "type": "object" }, "run_sheet": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "results": { "type": "array", "items": { "type": "object" } }, "completed_rows": { "type": "array", "items": { "type": "object" } } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "insights" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "outcome_report" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "optimization_cycle" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "job_drafts" }, "audit": { "type": "object" }, "audit_url": { "type": "boolean" }, "insights": { "type": "object" }, "review_gate": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "currency": { "type": "string" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "accept_job_draft" }, "draft": { "type": "object" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "currency": { "type": "string" }, "budget": { "type": "number" } }, "required": [ "url", "action", "draft" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "decide_job_draft" }, "decision": { "type": "string" }, "draft": { "type": "object" }, "draft_id": { "type": "string" }, "create_payload": { "type": "object" }, "reason": { "type": "string" }, "provider": { "type": "string" }, "evaluator": { "type": "string" }, "currency": { "type": "string" }, "budget": { "type": "number" } }, "required": [ "url", "action", "decision" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "draft_decisions" }, "decision": { "type": "string" }, "draft_id": { "type": "string" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "decision_reviews" }, "decision": { "type": "string" }, "apply_item_id": { "type": "string" }, "item_id": { "type": "string" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "jobs" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "c5_repair_history" } }, "required": [ "url", "action" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "const": "report_job_evidence" }, "job_id": { "type": "string" }, "evidence_uri": { "type": "string" }, "evidence": { "type": "object" } }, "required": [ "url", "action", "job_id" ] }, { "type": "object", "properties": { "url": { "type": "string" }, "agent_key": { "type": "string", "deprecated": true, "description": "Legacy body credential. Send the Site Agent Key as Authorization: Bearer instead; this body field remains accepted for backward compatibility." }, "action": { "type": "string", "enum": [ "a1_ai_reads", "a1_dashboard", "a1_package", "a1_read_evidence_package", "a2_citation_evidence_package", "a2_package", "accept_draft", "accept_job_draft", "acknowledge_insight", "agent_feed", "ai_citation_evidence_package", "ai_read_dashboard", "ai_read_evidence_package", "ai_read_logs", "apply_evidence", "apply_plan", "audit_file_package", "audit_report", "b1_conversion_evidence_package", "b1_conversions", "b1_package", "c5_repair_history", "citation_gap_matrix", "community_citation_plan", "connector_events", "connector_sdk_events", "content_optimization_plan", "content_pack", "content_publication_package", "content_repair_pack", "content_to_dashboard_loop", "content_workflow_package", "conversion_events", "conversion_evidence_package", "customer_performance_comparison", "customer_performance_history", "customer_performance_snapshot", "dashboard", "decide_job_draft", "decision_reviews", "draft_decisions", "evidence_pack", "execution_apply_plan", "execution_tracker", "i1_accept_job_draft", "i1_insights", "i1_job_drafts", "implementation_bundle", "insight_inbox", "insights", "insights_feed", "insights_job_drafts", "install_descriptor", "installation_verification", "job_drafts", "job_evidence", "job_status", "jobs", "list_jobs", "m19_apply_plan", "m1_outcome_evidence_package", "m1_outcome_report", "m1_package", "m20_apply_evidence", "m2_monthly_optimization_package", "m2_package", "m3_monthly_execution_tracker", "m3_tracker", "m4_monthly_outcome_scorecard", "m4_scorecard", "m5_dashboard", "m5_monthly_dashboard", "measurement_comparison", "measurement_history", "measurement_snapshot", "monthly_dashboard", "monthly_evidence_loop", "monthly_loop", "monthly_optimization_package", "monthly_package", "monthly_scorecard", "monthly_tracker", "optimization_cycle", "outcome_package", "outcome_report", "outcome_scorecard", "prompt_test_results", "prompt_test_run_sheet", "refresh_insight_inbox", "report_apply_evidence", "report_job_evidence", "s1_site_signals", "save_measurement_snapshot", "sdk_event_package", "sdk_insights", "site_agent_events", "site_agent_job_evidence", "site_agent_jobs", "site_apply_plan", "site_feed", "site_monthly_evidence_loop", "site_signal_package", "site_signals_package", "skill_package", "submit_apply_evidence" ] } }, "required": [ "url", "action" ] } ], "description": "One request per action; the action field selects the variant." } } } }, "responses": { "200": { "description": "Typed success payload; transcribed from the runtime handler.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SiteAgentCallResult" } } } }, "401": { "description": "Missing or invalid credential.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "402": { "description": "No active entitlement for a paid deliverable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "403": { "description": "Credential does not control the requested host.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "422": { "description": "Request understood but evidence is insufficient or contradictory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "429": { "description": "Rate limited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "500": { "description": "Unhandled error, carries a correlation id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } } } } } }, "components": { "schemas": { "Envelope": { "type": "object", "properties": { "ok": { "type": "boolean" }, "error": { "type": "string" }, "non_claims": { "type": "array", "items": { "type": "string" } } }, "required": [ "ok" ] }, "SiteAgentInstallGuide": { "type": "object", "description": "Machine-readable install guide; carries no ok field.", "properties": { "schema": { "type": "string" }, "audience": { "type": "string" }, "service": { "type": "string" }, "target": { "type": "string" }, "host": { "type": "string" }, "endpoints": { "type": "object", "additionalProperties": { "type": "string" } }, "verification_methods": { "type": "array", "items": { "type": "object" } }, "secret_policy": { "type": "object" }, "cli_installer": { "type": "object" }, "enterprise_installation": { "type": "object" }, "runtime_contract": { "type": "object" }, "repository_connector": { "type": "object" }, "sdk_examples": { "type": "object" }, "steps": { "type": "array", "items": { "type": "object" } }, "non_claims": { "type": "array", "items": { "type": "string" } }, "next_public_document": { "type": "string" } }, "required": [ "schema", "audience", "service", "endpoints", "steps", "non_claims" ] }, "SiteAgentRegistration": { "type": "object", "properties": { "ok": { "type": "boolean" }, "agent_id": { "type": "string" }, "tenant_id": { "type": "string" }, "host": { "type": "string" }, "base_url": { "type": "string" }, "plan": { "type": "string" }, "status": { "type": "string" }, "verification": { "type": "object", "properties": { "status": { "type": "string" }, "token": { "type": "string" }, "methods": { "type": "object" } }, "required": [ "status", "token", "methods" ] } }, "required": [ "ok", "agent_id", "tenant_id", "host", "status", "verification" ] }, "DomainVerificationResult": { "type": "object", "description": "First verification returns agent_key and install exactly once; later calls return key_already_issued with the recovery contract instead.", "properties": { "ok": { "type": "boolean" }, "agent_id": { "type": "string" }, "tenant_id": { "type": "string" }, "host": { "type": "string" }, "base_url": { "type": "string" }, "status": { "type": "string" }, "verification_status": { "type": "string" }, "verified_at": { "type": "number" }, "verification_receipt": { "type": "object" }, "site_token": { "type": "string" }, "agent_key": { "type": "string", "description": "Present only on first verification; never returned again." }, "install": { "type": "object" }, "key_already_issued": { "type": "boolean" }, "recovery": { "type": "object" } }, "required": [ "ok", "agent_id", "tenant_id", "host", "status", "verification_status", "verified_at", "site_token" ] }, "SiteAgentKeyVerification": { "type": "object", "properties": { "ok": { "type": "boolean" }, "site_agent": { "type": "object", "description": "Redacted site-agent record from verify_site_agent_key; fields may be null." }, "legacy_key_storage_detected": { "type": "boolean" }, "domain_proof_stale": { "type": "boolean" }, "domain_proof_age_seconds": { "type": "number" }, "recheck_endpoint": { "type": "string" } }, "required": [ "ok", "site_agent" ] }, "SiteAgentInstallStatus": { "type": "object", "properties": { "ok": { "type": "boolean" }, "schema": { "type": "string" }, "host": { "type": "string" }, "agent_id": { "type": "string" }, "status": { "type": "string", "enum": [ "not_installed", "pending_verification", "proof_published", "verified_domain", "sdk_active" ] }, "steps": { "type": "object", "additionalProperties": { "type": "boolean" } }, "proof_url": { "type": "string" }, "next_action": { "type": "string" }, "claim_boundary": { "type": "array", "items": { "type": "string" } }, "public_state": { "type": "object" }, "enterprise_challenge": { "type": "object" }, "human_status": { "type": "object" }, "gtm": { "type": "object" } }, "required": [ "ok", "schema", "host", "status", "steps", "next_action" ] }, "SiteKeyRecoveryChallenge": { "type": "object", "properties": { "ok": { "type": "boolean" }, "schema": { "type": "string" }, "challenge_id": { "type": "string" }, "tenant_id": { "type": "string" }, "host": { "type": "string" }, "agent_id": { "type": "string" }, "method": { "type": "string" }, "proof_name": { "type": "string" }, "proof_value": { "type": "string" }, "issued_at": { "type": "number" }, "expires_at": { "type": "number" }, "status": { "type": "string" }, "recovery_capability": { "type": "string", "description": "Returned exactly once; only a digest is stored server-side." }, "dns_txt": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } }, "one_time_secret_notice": { "type": "string" }, "next_steps": { "type": "array", "items": { "type": "string" } } }, "required": [ "ok", "challenge_id", "host", "agent_id", "recovery_capability", "expires_at" ] }, "SiteKeyLifecycleResult": { "type": "object", "description": "Shared by key recovery completion and rotation; receipt.event distinguishes them. The replacement agent_key is returned exactly once.", "properties": { "ok": { "type": "boolean" }, "host": { "type": "string" }, "agent_id": { "type": "string" }, "agent_key": { "type": "string" }, "receipt": { "type": "object" }, "one_time_secret_notice": { "type": "string" }, "old_credential_status": { "type": "string" }, "site_token_status": { "type": "string" }, "credential_generation_enforced": { "type": "boolean" }, "dashboard_pairings_revoked": { "type": "integer" }, "sessions_revoked": { "type": "integer" }, "oauth_tokens_revoked": { "type": "integer" }, "cleanup_status": { "type": "string" }, "cleanup_failures": { "type": "array", "items": { "type": "object" } } }, "required": [ "ok", "host", "agent_id", "agent_key", "receipt", "old_credential_status" ] }, "DashboardPairing": { "type": "object", "properties": { "ok": { "type": "boolean" }, "schema": { "type": "string" }, "login_url": { "type": "string", "description": "Single-use; embeds the pairing ticket." }, "expires_in": { "type": "number" }, "host": { "type": "string" }, "single_use": { "type": "boolean" } }, "required": [ "ok", "login_url", "expires_in", "single_use" ] }, "AuditCallResult": { "type": "object", "description": "Returned for measured and failed measurements alike; audit.ok distinguishes them and audit.score is null when unmeasured.", "properties": { "ok": { "type": "boolean" }, "lane": { "type": "string" }, "audit": { "type": "object", "properties": { "ok": { "type": "boolean" }, "url": { "type": "string" }, "measurement": { "type": "object" }, "score": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "dimensions": { "type": "object" }, "checks": { "type": "array", "items": { "type": "object" } }, "sources": { "type": "object" }, "evidence_pack": { "type": "object" }, "generated_at": { "type": "integer" } }, "required": [ "ok", "url", "measurement", "score", "dimensions", "checks", "sources", "evidence_pack", "generated_at" ] } }, "required": [ "ok", "lane", "audit" ] }, "AuditReportResult": { "type": "object", "properties": { "ok": { "type": "boolean" }, "measurement_status": { "type": "string" }, "report": { "type": "object" } }, "required": [ "ok", "measurement_status", "report" ] }, "SiteAgentActionCatalog": { "type": "object", "description": "Machine-readable private action catalog; carries no ok field.", "properties": { "schema": { "type": "string" }, "endpoint": { "type": "string" }, "auth": { "type": "object" }, "common_required_fields": { "type": "array", "items": { "type": "string" } }, "permission_endpoint": { "type": "string" }, "module_catalog": { "type": "array", "items": { "type": "object" } }, "actions": { "type": "array", "items": { "type": "object" } }, "non_claims": { "type": "array", "items": { "type": "string" } } }, "required": [ "schema", "endpoint", "auth", "actions", "non_claims" ] }, "SdkEventResult": { "type": "object", "description": "HTTP 200 covers acceptance and rejection; stored/activation carry the outcome.", "properties": { "ok": { "type": "boolean" }, "stored": { "type": "boolean" }, "event": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "agent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "activation": { "type": "object" }, "conversion_tracking": { "anyOf": [ { "type": "object" }, { "type": "null" } ] } }, "required": [ "ok", "stored", "activation" ] }, "EvidenceImportResult": { "type": "object", "properties": { "ok": { "type": "boolean" }, "stored": { "type": "integer" }, "skipped": { "type": "integer" }, "import": { "type": "object" }, "summary": { "type": "object" } }, "required": [ "ok", "stored", "skipped", "import", "summary" ] }, "EvidenceSummaryResult": { "type": "object", "properties": { "ok": { "type": "boolean" }, "summary": { "type": "object" } }, "required": [ "ok", "summary" ] }, "SiteAgentCallResult": { "type": "object", "description": "Common frame for every /api/site_agents/call action; the action-specific payload (install, feed, sync, evidence packages, ...) rides alongside these fields.", "properties": { "ok": { "type": "boolean" }, "lane": { "type": "string" }, "action": { "type": "string" }, "site_agent": { "type": "object", "description": "Redacted site-agent record from verify_site_agent_key; fields may be null." }, "install": { "type": "object" }, "feed": { "type": "object" }, "sync": { "type": "object" } }, "required": [ "ok", "lane", "action" ] } }, "securitySchemes": { "siteAgentKey": { "type": "http", "scheme": "bearer", "bearerFormat": "Site Agent Key", "description": "Issued only after domain ownership verification. Server-side only." } } } }