Download OpenAPI specification:
Community Core APIs for managed Conversation/Interaction facts, recorded Operations, and technical Trace reads. Standard record authorization applies. Enterprise business-provenance routes require an assembled EE image and runtime enterprise entitlement; they are not part of this Core specification. A plain 404 on an enterprise route does not identify its cause: an absent Community route, the EE availability gate, or an undisclosed record can return 404. A successful Core read does not establish access to an EE route. Explanation reads are separate from explicit EE generation requests. See the module README for the Community/EE read boundary.
Returns server-derived page capabilities and a scope fingerprint. Roles and managed resource identifiers are never accepted from or disclosed to the client.
{- "access_scope_fingerprint": "string",
- "allowed_log_categories": [
- "string"
], - "business_provenance_managed_networks": true,
- "business_provenance_own": true,
- "global_log_search": true,
- "log_export": true,
- "log_policy_read": true,
- "log_sensitive_fields": true,
- "management_audit": true,
- "observability_archive_manage": true,
- "security_audit": true,
- "technical_trace": true,
- "trace_evidence_configuration_read": true,
- "trace_evidence_configuration_write": true
}| limit | integer Page size, 1..100 |
{- "entries": [
- {
- "actor_name_snapshot": "string",
- "agent_name": "string",
- "business_context": "string",
- "closed_at": "string",
- "conversation_id": "string",
- "created_at": "string",
- "creation_auth_method": "string",
- "creation_request_id": "string",
- "external_conversation_key": "string",
- "generation": 0,
- "one_shot": true,
- "owner": {
- "application_principal_id": "string",
- "delegation_id": "string",
- "effective_subject_id": "string",
- "effective_subject_type": "user"
}, - "row_version": 0,
- "status": "active",
- "updated_at": "string"
}
]
}Managed Conversation request
| external_conversation_key required | string |
| idempotency_key | string |
| one_shot | boolean |
{- "external_conversation_key": "string",
- "idempotency_key": "string",
- "one_shot": true
}{- "actor_name_snapshot": "string",
- "agent_name": "string",
- "business_context": "string",
- "closed_at": "string",
- "conversation_id": "string",
- "created_at": "string",
- "creation_auth_method": "string",
- "creation_request_id": "string",
- "external_conversation_key": "string",
- "generation": 0,
- "one_shot": true,
- "owner": {
- "application_principal_id": "string",
- "delegation_id": "string",
- "effective_subject_id": "string",
- "effective_subject_type": "user"
}, - "row_version": 0,
- "status": "active",
- "updated_at": "string"
}| conversation_id required | string Conversation ID |
{- "actor_name_snapshot": "string",
- "agent_name": "string",
- "business_context": "string",
- "closed_at": "string",
- "conversation_id": "string",
- "created_at": "string",
- "creation_auth_method": "string",
- "creation_request_id": "string",
- "external_conversation_key": "string",
- "generation": 0,
- "one_shot": true,
- "owner": {
- "application_principal_id": "string",
- "delegation_id": "string",
- "effective_subject_id": "string",
- "effective_subject_type": "user"
}, - "row_version": 0,
- "status": "active",
- "updated_at": "string"
}| conversation_id required | string Conversation ID |
Idempotent close request
| idempotency_key | string |
{- "idempotency_key": "string"
}{- "actor_name_snapshot": "string",
- "agent_name": "string",
- "business_context": "string",
- "closed_at": "string",
- "conversation_id": "string",
- "created_at": "string",
- "creation_auth_method": "string",
- "creation_request_id": "string",
- "external_conversation_key": "string",
- "generation": 0,
- "one_shot": true,
- "owner": {
- "application_principal_id": "string",
- "delegation_id": "string",
- "effective_subject_id": "string",
- "effective_subject_type": "user"
}, - "row_version": 0,
- "status": "active",
- "updated_at": "string"
}| conversation_id required | string Conversation ID |
Interaction start request
| agent_name | string <= 128 characters |
| idempotency_key required | string |
| lease_seconds | integer |
| request_hash | string |
{- "agent_name": "string",
- "idempotency_key": "string",
- "lease_seconds": 0,
- "request_hash": "string"
}{- "closure_manifest": {
- "answer_artifact_persistence": {
- "content_hash": "string",
- "event_id": "string",
- "state": "pending"
}, - "answer_artifact_ref": "string",
- "assembler_deadline": "string",
- "claims": [
- "string"
], - "completion_manifest_version": "string",
- "completion_reason": "string",
- "expected_operations": [
- {
- "operation_id": "string",
- "required": true
}
], - "expected_receipts": [
- {
- "receipt_id": "string",
- "required": true
}
], - "system_partial_reasons": [
- "string"
]
}, - "conversation_id": "string",
- "created_at": "string",
- "evidence_status": "not_applicable",
- "execution_status": "active",
- "interaction_id": "string",
- "lease_epoch": 0,
- "lease_expires_at": "string",
- "lease_token": "string",
- "lease_version": 0,
- "ordinal": 0,
- "row_version": 0,
- "terminal_at": "string",
- "updated_at": "string"
}| conversation_id required | string Conversation ID |
| interaction_id required | string Interaction ID |
Operation intent
object (sessionvo.CapabilityProfile) | |
| causation_event_ids | Array of strings |
required | object (sessionvo.PayloadEnvelope) |
| lease_epoch required | integer |
| lease_token required | string |
| operation_key required | string |
| parent_operation_id | string |
| protocol required | string (sessionvo.OperationProtocol) Enum: "mcp" "sdk" "internal" |
| required | boolean |
| source_module required | string |
| tool_name required | string |
{- "capability_profile": {
- "canonical_tool_name": "string",
- "child_evidence_policy": "string",
- "evidence_contract": "string",
- "execution_role": "string",
- "failure_policy": "string",
- "input_schema_digest": "string",
- "manifest_id": "string",
- "manifest_version": "string",
- "mapper_id": "string",
- "mapper_version": "string",
- "minimum_trace_schema": "string",
- "output_schema_digest": "string",
- "reason": "string",
- "required_trace_fields": [
- "string"
], - "resolution": "string",
- "tool_version": "string"
}, - "causation_event_ids": [
- "string"
], - "input": {
- "byte_length": 0,
- "inline": [
- 0
], - "media_type": "string",
- "mode": "inline",
- "omitted_reason": "string",
- "ref": "string"
}, - "lease_epoch": 0,
- "lease_token": "string",
- "operation_key": "string",
- "parent_operation_id": "string",
- "protocol": "mcp",
- "required": true,
- "source_module": "string",
- "tool_name": "string"
}{- "created": true,
- "execute": true,
- "operation": {
- "attempt": 0,
- "attempt_status": "ready",
- "causation_event_ids": [
- "string"
], - "conversation_id": "string",
- "created_at": "string",
- "interaction_id": "string",
- "operation_id": "string",
- "operation_key": "string",
- "parent_operation_id": "string",
- "retryable": true,
- "row_version": 0,
- "tool_name": "string",
- "updated_at": "string"
}, - "receipt": {
- "artifact_refs": [
- "string"
], - "attempt": 0,
- "business_refs": [
- {
- "as_of": "string",
- "display_hint": "string",
- "ref_id": "string",
- "ref_type": "knowledge_network",
- "version": "string"
}
], - "causation_event_ids": [
- "string"
], - "conversation_id": "string",
- "evidence_durability": "pending",
- "interaction_id": "string",
- "issued_at": "string",
- "observed_evidence_refs": [
- "string"
], - "operation_id": "string",
- "operation_key": "string",
- "owner": {
- "application_principal_id": "string",
- "delegation_id": "string",
- "effective_subject_id": "string",
- "effective_subject_type": "user"
}, - "partial_reasons": [
- "string"
], - "receipt_id": "string",
- "receipt_status": "pending",
- "request_id": "string",
- "required": true,
- "row_version": 0,
- "schema_version": "string",
- "terminal_at": "string",
- "tool_name": "string",
- "trace_id": "string"
}
}New generation request
| external_conversation_key required | string |
| idempotency_key | string |
| one_shot | boolean |
{- "external_conversation_key": "string",
- "idempotency_key": "string",
- "one_shot": true
}{- "actor_name_snapshot": "string",
- "agent_name": "string",
- "business_context": "string",
- "closed_at": "string",
- "conversation_id": "string",
- "created_at": "string",
- "creation_auth_method": "string",
- "creation_request_id": "string",
- "external_conversation_key": "string",
- "generation": 0,
- "one_shot": true,
- "owner": {
- "application_principal_id": "string",
- "delegation_id": "string",
- "effective_subject_id": "string",
- "effective_subject_type": "user"
}, - "row_version": 0,
- "status": "active",
- "updated_at": "string"
}Managed Conversation request
| external_conversation_key required | string |
| idempotency_key | string |
| one_shot | boolean |
{- "external_conversation_key": "string",
- "idempotency_key": "string",
- "one_shot": true
}{- "actor_name_snapshot": "string",
- "agent_name": "string",
- "business_context": "string",
- "closed_at": "string",
- "conversation_id": "string",
- "created_at": "string",
- "creation_auth_method": "string",
- "creation_request_id": "string",
- "external_conversation_key": "string",
- "generation": 0,
- "one_shot": true,
- "owner": {
- "application_principal_id": "string",
- "delegation_id": "string",
- "effective_subject_id": "string",
- "effective_subject_type": "user"
}, - "row_version": 0,
- "status": "active",
- "updated_at": "string"
}Conversation resume request
| conversation_id required | string |
{- "conversation_id": "string"
}{- "actor_name_snapshot": "string",
- "agent_name": "string",
- "business_context": "string",
- "closed_at": "string",
- "conversation_id": "string",
- "created_at": "string",
- "creation_auth_method": "string",
- "creation_request_id": "string",
- "external_conversation_key": "string",
- "generation": 0,
- "one_shot": true,
- "owner": {
- "application_principal_id": "string",
- "delegation_id": "string",
- "effective_subject_id": "string",
- "effective_subject_type": "user"
}, - "row_version": 0,
- "status": "active",
- "updated_at": "string"
}| interaction_id required | string Interaction ID |
{- "closure_manifest": {
- "answer_artifact_persistence": {
- "content_hash": "string",
- "event_id": "string",
- "state": "pending"
}, - "answer_artifact_ref": "string",
- "assembler_deadline": "string",
- "claims": [
- "string"
], - "completion_manifest_version": "string",
- "completion_reason": "string",
- "expected_operations": [
- {
- "operation_id": "string",
- "required": true
}
], - "expected_receipts": [
- {
- "receipt_id": "string",
- "required": true
}
], - "system_partial_reasons": [
- "string"
]
}, - "conversation_id": "string",
- "created_at": "string",
- "evidence_status": "not_applicable",
- "execution_status": "active",
- "interaction_id": "string",
- "lease_epoch": 0,
- "lease_expires_at": "string",
- "lease_token": "string",
- "lease_version": 0,
- "ordinal": 0,
- "row_version": 0,
- "terminal_at": "string",
- "updated_at": "string"
}| interaction_id required | string Interaction ID |
Terminal closure manifest
| answer_artifact_ref | string |
| assembler_deadline | string |
| claims | Array of strings |
| completion_manifest_version required | string |
| completion_reason required | string |
Array of objects (httphandler.expectedOperationRequest) | |
Array of objects (httphandler.expectedReceiptRequest) | |
| lease_epoch required | integer |
| lease_token required | string |
| terminal_idempotency_key required | string |
{- "answer_artifact_ref": "string",
- "assembler_deadline": "string",
- "claims": [
- "string"
], - "completion_manifest_version": "string",
- "completion_reason": "string",
- "expected_operations": [
- {
- "operation_id": "string",
- "required": true
}
], - "expected_receipts": [
- {
- "receipt_id": "string",
- "required": true
}
], - "lease_epoch": 0,
- "lease_token": "string",
- "terminal_idempotency_key": "string"
}{- "closure_manifest": {
- "answer_artifact_persistence": {
- "content_hash": "string",
- "event_id": "string",
- "state": "pending"
}, - "answer_artifact_ref": "string",
- "assembler_deadline": "string",
- "claims": [
- "string"
], - "completion_manifest_version": "string",
- "completion_reason": "string",
- "expected_operations": [
- {
- "operation_id": "string",
- "required": true
}
], - "expected_receipts": [
- {
- "receipt_id": "string",
- "required": true
}
], - "system_partial_reasons": [
- "string"
]
}, - "conversation_id": "string",
- "created_at": "string",
- "evidence_status": "not_applicable",
- "execution_status": "active",
- "interaction_id": "string",
- "lease_epoch": 0,
- "lease_expires_at": "string",
- "lease_token": "string",
- "lease_version": 0,
- "ordinal": 0,
- "row_version": 0,
- "terminal_at": "string",
- "updated_at": "string"
}| interaction_id required | string Interaction ID |
Terminal closure manifest
| answer_artifact_ref | string |
| assembler_deadline | string |
| claims | Array of strings |
| completion_manifest_version required | string |
| completion_reason required | string |
Array of objects (httphandler.expectedOperationRequest) | |
Array of objects (httphandler.expectedReceiptRequest) | |
| lease_epoch required | integer |
| lease_token required | string |
| terminal_idempotency_key required | string |
{- "answer_artifact_ref": "string",
- "assembler_deadline": "string",
- "claims": [
- "string"
], - "completion_manifest_version": "string",
- "completion_reason": "string",
- "expected_operations": [
- {
- "operation_id": "string",
- "required": true
}
], - "expected_receipts": [
- {
- "receipt_id": "string",
- "required": true
}
], - "lease_epoch": 0,
- "lease_token": "string",
- "terminal_idempotency_key": "string"
}{- "closure_manifest": {
- "answer_artifact_persistence": {
- "content_hash": "string",
- "event_id": "string",
- "state": "pending"
}, - "answer_artifact_ref": "string",
- "assembler_deadline": "string",
- "claims": [
- "string"
], - "completion_manifest_version": "string",
- "completion_reason": "string",
- "expected_operations": [
- {
- "operation_id": "string",
- "required": true
}
], - "expected_receipts": [
- {
- "receipt_id": "string",
- "required": true
}
], - "system_partial_reasons": [
- "string"
]
}, - "conversation_id": "string",
- "created_at": "string",
- "evidence_status": "not_applicable",
- "execution_status": "active",
- "interaction_id": "string",
- "lease_epoch": 0,
- "lease_expires_at": "string",
- "lease_token": "string",
- "lease_version": 0,
- "ordinal": 0,
- "row_version": 0,
- "terminal_at": "string",
- "updated_at": "string"
}| interaction_id required | string Interaction ID |
Terminal closure manifest
| answer_artifact_ref | string |
| assembler_deadline | string |
| claims | Array of strings |
| completion_manifest_version required | string |
| completion_reason required | string |
Array of objects (httphandler.expectedOperationRequest) | |
Array of objects (httphandler.expectedReceiptRequest) | |
| lease_epoch required | integer |
| lease_token required | string |
| terminal_idempotency_key required | string |
{- "answer_artifact_ref": "string",
- "assembler_deadline": "string",
- "claims": [
- "string"
], - "completion_manifest_version": "string",
- "completion_reason": "string",
- "expected_operations": [
- {
- "operation_id": "string",
- "required": true
}
], - "expected_receipts": [
- {
- "receipt_id": "string",
- "required": true
}
], - "lease_epoch": 0,
- "lease_token": "string",
- "terminal_idempotency_key": "string"
}{- "closure_manifest": {
- "answer_artifact_persistence": {
- "content_hash": "string",
- "event_id": "string",
- "state": "pending"
}, - "answer_artifact_ref": "string",
- "assembler_deadline": "string",
- "claims": [
- "string"
], - "completion_manifest_version": "string",
- "completion_reason": "string",
- "expected_operations": [
- {
- "operation_id": "string",
- "required": true
}
], - "expected_receipts": [
- {
- "receipt_id": "string",
- "required": true
}
], - "system_partial_reasons": [
- "string"
]
}, - "conversation_id": "string",
- "created_at": "string",
- "evidence_status": "not_applicable",
- "execution_status": "active",
- "interaction_id": "string",
- "lease_epoch": 0,
- "lease_expires_at": "string",
- "lease_token": "string",
- "lease_version": 0,
- "ordinal": 0,
- "row_version": 0,
- "terminal_at": "string",
- "updated_at": "string"
}Derives the current lease and closure manifest from authoritative Operations and Receipts. Ordinary Agents do not submit concurrency or closure internals. When durable answer handoff is enabled, optional answer_artifact uses the EvidenceArtifact contract (result type, at most 16 MiB) and is staged in the same SQL transaction as business completion. completed with evidence_status=assembling means evidence delivery is pending, not complete. Existing answer_artifact_ref requests remain supported.
| interaction_id required | string Interaction ID |
Managed finish request
| answer_artifact | object AnswerArtifact is an opt-in EvidenceArtifact result object, at most 16 MiB, durably staged with the completed Interaction. |
| answer_artifact_ref | string |
| claims | Array of strings |
| idempotency_key required | string |
| outcome required | string |
| partial_reasons | Array of strings |
| reason | string |
{- "answer_artifact": { },
- "answer_artifact_ref": "string",
- "claims": [
- "string"
], - "idempotency_key": "string",
- "outcome": "string",
- "partial_reasons": [
- "string"
], - "reason": "string"
}{- "closure_manifest": {
- "answer_artifact_persistence": {
- "content_hash": "string",
- "event_id": "string",
- "state": "pending"
}, - "answer_artifact_ref": "string",
- "assembler_deadline": "string",
- "claims": [
- "string"
], - "completion_manifest_version": "string",
- "completion_reason": "string",
- "expected_operations": [
- {
- "operation_id": "string",
- "required": true
}
], - "expected_receipts": [
- {
- "receipt_id": "string",
- "required": true
}
], - "system_partial_reasons": [
- "string"
]
}, - "conversation_id": "string",
- "created_at": "string",
- "evidence_status": "not_applicable",
- "execution_status": "active",
- "interaction_id": "string",
- "lease_epoch": 0,
- "lease_expires_at": "string",
- "lease_token": "string",
- "lease_version": 0,
- "ordinal": 0,
- "row_version": 0,
- "terminal_at": "string",
- "updated_at": "string"
}| interaction_id required | string Interaction ID |
Terminal closure manifest
| answer_artifact_ref | string |
| assembler_deadline | string |
| claims | Array of strings |
| completion_manifest_version required | string |
| completion_reason required | string |
Array of objects (httphandler.expectedOperationRequest) | |
Array of objects (httphandler.expectedReceiptRequest) | |
| lease_epoch required | integer |
| lease_token required | string |
| terminal_idempotency_key required | string |
{- "answer_artifact_ref": "string",
- "assembler_deadline": "string",
- "claims": [
- "string"
], - "completion_manifest_version": "string",
- "completion_reason": "string",
- "expected_operations": [
- {
- "operation_id": "string",
- "required": true
}
], - "expected_receipts": [
- {
- "receipt_id": "string",
- "required": true
}
], - "lease_epoch": 0,
- "lease_token": "string",
- "terminal_idempotency_key": "string"
}{- "closure_manifest": {
- "answer_artifact_persistence": {
- "content_hash": "string",
- "event_id": "string",
- "state": "pending"
}, - "answer_artifact_ref": "string",
- "assembler_deadline": "string",
- "claims": [
- "string"
], - "completion_manifest_version": "string",
- "completion_reason": "string",
- "expected_operations": [
- {
- "operation_id": "string",
- "required": true
}
], - "expected_receipts": [
- {
- "receipt_id": "string",
- "required": true
}
], - "system_partial_reasons": [
- "string"
]
}, - "conversation_id": "string",
- "created_at": "string",
- "evidence_status": "not_applicable",
- "execution_status": "active",
- "interaction_id": "string",
- "lease_epoch": 0,
- "lease_expires_at": "string",
- "lease_token": "string",
- "lease_version": 0,
- "ordinal": 0,
- "row_version": 0,
- "terminal_at": "string",
- "updated_at": "string"
}| interaction_id required | string Interaction ID |
| view | string Enum: "full" "summary" Response view: full (default) or summary |
{- "entries": [
- {
- "attempt": 0,
- "capability_profile": {
- "canonical_tool_name": "string",
- "child_evidence_policy": "string",
- "evidence_contract": "string",
- "execution_role": "string",
- "failure_policy": "string",
- "input_schema_digest": "string",
- "manifest_id": "string",
- "manifest_version": "string",
- "mapper_id": "string",
- "mapper_version": "string",
- "minimum_trace_schema": "string",
- "output_schema_digest": "string",
- "reason": "string",
- "required_trace_fields": [
- "string"
], - "resolution": "string",
- "tool_version": "string"
}, - "conversation_id": "string",
- "error": {
- "byte_length": 0,
- "inline": [
- 0
], - "media_type": "string",
- "mode": "inline",
- "omitted_reason": "string",
- "ref": "string"
}, - "evidence_completion": {
- "expectation": {
- "closed": true,
- "events": [
- {
- "drop_reason": "string",
- "event_id": "string",
- "event_type": "string",
- "payload_hash": "string",
- "producer_id": "string",
- "publish_disposition": "string"
}
], - "version": 0
}, - "original_durability": "pending",
- "original_observed_refs": [
- "string"
], - "original_partial_reasons": [
- "string"
], - "rejected_expectation_hash": "string",
- "rejection_reason": "string"
}, - "finished_at": "string",
- "input": {
- "byte_length": 0,
- "inline": [
- 0
], - "media_type": "string",
- "mode": "inline",
- "omitted_reason": "string",
- "ref": "string"
}, - "interaction_id": "string",
- "operation_id": "string",
- "output": {
- "byte_length": 0,
- "inline": [
- 0
], - "media_type": "string",
- "mode": "inline",
- "omitted_reason": "string",
- "ref": "string"
}, - "parent_operation_id": "string",
- "protocol": "mcp",
- "receipt_id": "string",
- "request_id": "string",
- "retryable": true,
- "source_module": "string",
- "span_id": "string",
- "started_at": "string",
- "status": "ready",
- "tool_name": "string",
- "trace_id": "string"
}
], - "total": 0
}| operation_id required | string Operation ID |
{- "attempt": 0,
- "attempt_status": "ready",
- "causation_event_ids": [
- "string"
], - "conversation_id": "string",
- "created_at": "string",
- "interaction_id": "string",
- "operation_id": "string",
- "operation_key": "string",
- "parent_operation_id": "string",
- "retryable": true,
- "row_version": 0,
- "tool_name": "string",
- "updated_at": "string"
}| operation_id required | string Operation ID |
Current Interaction lease
| lease_epoch required | integer |
| lease_token required | string |
{- "lease_epoch": 0,
- "lease_token": "string"
}{- "created": true,
- "execute": true,
- "operation": {
- "attempt": 0,
- "attempt_status": "ready",
- "causation_event_ids": [
- "string"
], - "conversation_id": "string",
- "created_at": "string",
- "interaction_id": "string",
- "operation_id": "string",
- "operation_key": "string",
- "parent_operation_id": "string",
- "retryable": true,
- "row_version": 0,
- "tool_name": "string",
- "updated_at": "string"
}, - "receipt": {
- "artifact_refs": [
- "string"
], - "attempt": 0,
- "business_refs": [
- {
- "as_of": "string",
- "display_hint": "string",
- "ref_id": "string",
- "ref_type": "knowledge_network",
- "version": "string"
}
], - "causation_event_ids": [
- "string"
], - "conversation_id": "string",
- "evidence_durability": "pending",
- "interaction_id": "string",
- "issued_at": "string",
- "observed_evidence_refs": [
- "string"
], - "operation_id": "string",
- "operation_key": "string",
- "owner": {
- "application_principal_id": "string",
- "delegation_id": "string",
- "effective_subject_id": "string",
- "effective_subject_type": "user"
}, - "partial_reasons": [
- "string"
], - "receipt_id": "string",
- "receipt_status": "pending",
- "request_id": "string",
- "required": true,
- "row_version": 0,
- "schema_version": "string",
- "terminal_at": "string",
- "tool_name": "string",
- "trace_id": "string"
}
}| operation_id required | string Operation ID |
| attempt required | integer Attempt number |
{- "attempt": 0,
- "capability_profile": {
- "canonical_tool_name": "string",
- "child_evidence_policy": "string",
- "evidence_contract": "string",
- "execution_role": "string",
- "failure_policy": "string",
- "input_schema_digest": "string",
- "manifest_id": "string",
- "manifest_version": "string",
- "mapper_id": "string",
- "mapper_version": "string",
- "minimum_trace_schema": "string",
- "output_schema_digest": "string",
- "reason": "string",
- "required_trace_fields": [
- "string"
], - "resolution": "string",
- "tool_version": "string"
}, - "conversation_id": "string",
- "error": {
- "byte_length": 0,
- "inline": [
- 0
], - "media_type": "string",
- "mode": "inline",
- "omitted_reason": "string",
- "ref": "string"
}, - "evidence_completion": {
- "expectation": {
- "closed": true,
- "events": [
- {
- "drop_reason": "string",
- "event_id": "string",
- "event_type": "string",
- "payload_hash": "string",
- "producer_id": "string",
- "publish_disposition": "string"
}
], - "version": 0
}, - "original_durability": "pending",
- "original_observed_refs": [
- "string"
], - "original_partial_reasons": [
- "string"
], - "rejected_expectation_hash": "string",
- "rejection_reason": "string"
}, - "finished_at": "string",
- "input": {
- "byte_length": 0,
- "inline": [
- 0
], - "media_type": "string",
- "mode": "inline",
- "omitted_reason": "string",
- "ref": "string"
}, - "interaction_id": "string",
- "operation_id": "string",
- "output": {
- "byte_length": 0,
- "inline": [
- 0
], - "media_type": "string",
- "mode": "inline",
- "omitted_reason": "string",
- "ref": "string"
}, - "parent_operation_id": "string",
- "protocol": "mcp",
- "receipt_id": "string",
- "request_id": "string",
- "retryable": true,
- "source_module": "string",
- "span_id": "string",
- "started_at": "string",
- "status": "ready",
- "tool_name": "string",
- "trace_id": "string"
}| operation_id required | string Operation ID |
| attempt required | integer Attempt number |
Durable operation result
| artifact_refs | Array of strings |
Array of objects (sessionvo.BusinessRef) | |
object (sessionvo.PayloadEnvelope) | |
| evidence_durability required | string (sessionvo.EvidenceDurability) Enum: "pending" "durable" "failed" |
object (sessionvo.EvidenceExpectation) | |
| observed_evidence_refs | Array of strings |
object (sessionvo.PayloadEnvelope) | |
| partial_reasons | Array of strings |
| receipt_id required | string |
| request_id required | string |
| retryable | boolean |
| span_id | string |
| trace_id required | string |
{- "artifact_refs": [
- "string"
], - "business_refs": [
- {
- "as_of": "string",
- "display_hint": "string",
- "ref_id": "string",
- "ref_type": "knowledge_network",
- "version": "string"
}
], - "error": {
- "byte_length": 0,
- "inline": [
- 0
], - "media_type": "string",
- "mode": "inline",
- "omitted_reason": "string",
- "ref": "string"
}, - "evidence_durability": "pending",
- "evidence_expectation": {
- "closed": true,
- "events": [
- {
- "drop_reason": "string",
- "event_id": "string",
- "event_type": "string",
- "payload_hash": "string",
- "producer_id": "string",
- "publish_disposition": "string"
}
], - "version": 0
}, - "observed_evidence_refs": [
- "string"
], - "output": {
- "byte_length": 0,
- "inline": [
- 0
], - "media_type": "string",
- "mode": "inline",
- "omitted_reason": "string",
- "ref": "string"
}, - "partial_reasons": [
- "string"
], - "receipt_id": "string",
- "request_id": "string",
- "retryable": true,
- "span_id": "string",
- "trace_id": "string"
}{- "created": true,
- "execute": true,
- "operation": {
- "attempt": 0,
- "attempt_status": "ready",
- "causation_event_ids": [
- "string"
], - "conversation_id": "string",
- "created_at": "string",
- "interaction_id": "string",
- "operation_id": "string",
- "operation_key": "string",
- "parent_operation_id": "string",
- "retryable": true,
- "row_version": 0,
- "tool_name": "string",
- "updated_at": "string"
}, - "receipt": {
- "artifact_refs": [
- "string"
], - "attempt": 0,
- "business_refs": [
- {
- "as_of": "string",
- "display_hint": "string",
- "ref_id": "string",
- "ref_type": "knowledge_network",
- "version": "string"
}
], - "causation_event_ids": [
- "string"
], - "conversation_id": "string",
- "evidence_durability": "pending",
- "interaction_id": "string",
- "issued_at": "string",
- "observed_evidence_refs": [
- "string"
], - "operation_id": "string",
- "operation_key": "string",
- "owner": {
- "application_principal_id": "string",
- "delegation_id": "string",
- "effective_subject_id": "string",
- "effective_subject_type": "user"
}, - "partial_reasons": [
- "string"
], - "receipt_id": "string",
- "receipt_status": "pending",
- "request_id": "string",
- "required": true,
- "row_version": 0,
- "schema_version": "string",
- "terminal_at": "string",
- "tool_name": "string",
- "trace_id": "string"
}
}| operation_id required | string Operation ID |
| attempt required | integer Attempt number |
Durable operation failure
| artifact_refs | Array of strings |
Array of objects (sessionvo.BusinessRef) | |
object (sessionvo.PayloadEnvelope) | |
| evidence_durability required | string (sessionvo.EvidenceDurability) Enum: "pending" "durable" "failed" |
object (sessionvo.EvidenceExpectation) | |
| observed_evidence_refs | Array of strings |
object (sessionvo.PayloadEnvelope) | |
| partial_reasons | Array of strings |
| receipt_id required | string |
| request_id required | string |
| retryable | boolean |
| span_id | string |
| trace_id required | string |
{- "artifact_refs": [
- "string"
], - "business_refs": [
- {
- "as_of": "string",
- "display_hint": "string",
- "ref_id": "string",
- "ref_type": "knowledge_network",
- "version": "string"
}
], - "error": {
- "byte_length": 0,
- "inline": [
- 0
], - "media_type": "string",
- "mode": "inline",
- "omitted_reason": "string",
- "ref": "string"
}, - "evidence_durability": "pending",
- "evidence_expectation": {
- "closed": true,
- "events": [
- {
- "drop_reason": "string",
- "event_id": "string",
- "event_type": "string",
- "payload_hash": "string",
- "producer_id": "string",
- "publish_disposition": "string"
}
], - "version": 0
}, - "observed_evidence_refs": [
- "string"
], - "output": {
- "byte_length": 0,
- "inline": [
- 0
], - "media_type": "string",
- "mode": "inline",
- "omitted_reason": "string",
- "ref": "string"
}, - "partial_reasons": [
- "string"
], - "receipt_id": "string",
- "request_id": "string",
- "retryable": true,
- "span_id": "string",
- "trace_id": "string"
}{- "created": true,
- "execute": true,
- "operation": {
- "attempt": 0,
- "attempt_status": "ready",
- "causation_event_ids": [
- "string"
], - "conversation_id": "string",
- "created_at": "string",
- "interaction_id": "string",
- "operation_id": "string",
- "operation_key": "string",
- "parent_operation_id": "string",
- "retryable": true,
- "row_version": 0,
- "tool_name": "string",
- "updated_at": "string"
}, - "receipt": {
- "artifact_refs": [
- "string"
], - "attempt": 0,
- "business_refs": [
- {
- "as_of": "string",
- "display_hint": "string",
- "ref_id": "string",
- "ref_type": "knowledge_network",
- "version": "string"
}
], - "causation_event_ids": [
- "string"
], - "conversation_id": "string",
- "evidence_durability": "pending",
- "interaction_id": "string",
- "issued_at": "string",
- "observed_evidence_refs": [
- "string"
], - "operation_id": "string",
- "operation_key": "string",
- "owner": {
- "application_principal_id": "string",
- "delegation_id": "string",
- "effective_subject_id": "string",
- "effective_subject_type": "user"
}, - "partial_reasons": [
- "string"
], - "receipt_id": "string",
- "receipt_status": "pending",
- "request_id": "string",
- "required": true,
- "row_version": 0,
- "schema_version": "string",
- "terminal_at": "string",
- "tool_name": "string",
- "trace_id": "string"
}
}| receipt_id required | string Receipt ID |
{- "artifact_refs": [
- "string"
], - "attempt": 0,
- "business_refs": [
- {
- "as_of": "string",
- "display_hint": "string",
- "ref_id": "string",
- "ref_type": "knowledge_network",
- "version": "string"
}
], - "causation_event_ids": [
- "string"
], - "conversation_id": "string",
- "evidence_durability": "pending",
- "interaction_id": "string",
- "issued_at": "string",
- "observed_evidence_refs": [
- "string"
], - "operation_id": "string",
- "operation_key": "string",
- "owner": {
- "application_principal_id": "string",
- "delegation_id": "string",
- "effective_subject_id": "string",
- "effective_subject_type": "user"
}, - "partial_reasons": [
- "string"
], - "receipt_id": "string",
- "receipt_status": "pending",
- "request_id": "string",
- "required": true,
- "row_version": 0,
- "schema_version": "string",
- "terminal_at": "string",
- "tool_name": "string",
- "trace_id": "string"
}| limit | integer Page size, 1..100 |
{- "entries": [
- {
- "conversation_id": "string",
- "interaction_id": "string",
- "operation_count": 0,
- "receipt_count": 0,
- "request_id": "string",
- "trace_ids": [
- "string"
], - "updated_at": "string"
}
], - "next_cursor": "string"
}| request_id required | string Request ID |
{- "conversation_id": "string",
- "interaction_id": "string",
- "operation_count": 0,
- "receipt_count": 0,
- "request_id": "string",
- "trace_ids": [
- "string"
], - "updated_at": "string"
}Stores authorized business content separately from evidence events. Inline content and snapshot_ref are mutually exclusive.
BKN Trace 2.2 evidence artifact
| agent_or_app | string |
| application_principal_id | string |
| artifact_id | string |
| artifact_type | string (evidencevo.ArtifactType) Enum: "question" "result" "query" "data_result" "logic_execution" "action_input" "action_result" |
| as_of | string |
| bkn.account.id | string |
| bkn.account.type | string |
| bkn.request.id | string |
| business_refs | Array of strings |
| claim_id | string |
| content | any |
| content_hash | string |
| content_type | string |
| effective_subject_id | string |
| initiator | string |
| interaction_id | string |
| knowledge_network_ids | Array of strings |
| observed_at | string |
| operation_id | string |
| schema_version | string |
| snapshot_ref | string |
| source_ref | string |
| source_version | string |
| trace_id | string |
{- "agent_or_app": "string",
- "application_principal_id": "string",
- "artifact_id": "string",
- "artifact_type": "question",
- "as_of": "string",
- "bkn.account.id": "string",
- "bkn.account.type": "string",
- "bkn.request.id": "string",
- "business_refs": [
- "string"
], - "claim_id": "string",
- "content": null,
- "content_hash": "string",
- "content_type": "string",
- "effective_subject_id": "string",
- "initiator": "string",
- "interaction_id": "string",
- "knowledge_network_ids": [
- "string"
], - "observed_at": "string",
- "operation_id": "string",
- "schema_version": "string",
- "snapshot_ref": "string",
- "source_ref": "string",
- "source_version": "string",
- "trace_id": "string"
}{- "artifact_id": "string",
- "artifact_type": "question",
- "bkn.request.id": "string",
- "content_hash": "string",
- "created": true,
- "trace_id": "string"
}Returns an artifact through its own record scope, or through an authorized Interaction when interaction_id is supplied.
| artifact_id required | string Artifact ID |
| interaction_id | string Authorized Interaction ID |
{- "agent_or_app": "string",
- "application_principal_id": "string",
- "artifact_id": "string",
- "artifact_type": "question",
- "as_of": "string",
- "bkn.account.id": "string",
- "bkn.account.type": "string",
- "bkn.request.id": "string",
- "business_refs": [
- "string"
], - "claim_id": "string",
- "content": null,
- "content_hash": "string",
- "content_type": "string",
- "effective_subject_id": "string",
- "initiator": "string",
- "interaction_id": "string",
- "knowledge_network_ids": [
- "string"
], - "observed_at": "string",
- "operation_id": "string",
- "schema_version": "string",
- "snapshot_ref": "string",
- "source_ref": "string",
- "source_version": "string",
- "trace_id": "string"
}Commits the immutable Evidence Ledger record and Projection Outbox in one transaction before returning durable_ack.
BKN Trace 3.0 evidence event
| artifact_refs | Array of strings |
| attempt | integer |
| bkn.trace.schema.version required | string |
Array of objects (sessionvo.BusinessRef) | |
| causation_event_ids | Array of strings |
Array of objects (sessionvo.Claim) | |
| conversation_id required | string |
| emitted_at required | string |
| envelope required | Array of integers |
| event_id required | string |
| event_type required | string |
Array of objects (sessionvo.EvidenceRef) | |
| interaction_id required | string |
| observed_at required | string |
Array of objects (sessionvo.OperationBusinessEdge) | |
| operation_id | string |
| payload_hash required | string |
| producer_epoch required | integer |
| producer_id required | string |
| producer_sequence required | integer |
| producer_stream_id required | string |
| request_id | string |
| span_id | string |
| started_at required | string |
| trace_id | string |
{- "artifact_refs": [
- "string"
], - "attempt": 0,
- "bkn.trace.schema.version": "string",
- "business_refs": [
- {
- "as_of": "string",
- "display_hint": "string",
- "ref_id": "string",
- "ref_type": "knowledge_network",
- "version": "string"
}
], - "causation_event_ids": [
- "string"
], - "claims": [
- {
- "claim_id": "string",
- "claim_status": "asserted",
- "claim_type": "string",
- "content_artifact_ref": "string",
- "materiality": "material",
- "required_support_roles": [
- "string"
], - "supports": [
- {
- "content_hash": "string",
- "fragment_selector": "string",
- "reason": "string",
- "role": "string",
- "source_interaction_id": "string",
- "source_operation_id": "string",
- "source_revision_id": "string",
- "status": "adopted",
- "target_ref": "string",
- "target_type": "evidence",
- "version": "string"
}
]
}
], - "conversation_id": "string",
- "emitted_at": "string",
- "envelope": [
- 0
], - "event_id": "string",
- "event_type": "string",
- "evidence_refs": [
- {
- "artifact_ref": "string",
- "as_of": "string",
- "content_hash": "string",
- "evidence_ref": "string",
- "fragment_selector": "string",
- "ref_type": "event",
- "source_interaction_id": "string",
- "source_operation_id": "string",
- "source_revision_id": "string",
- "version": "string"
}
], - "interaction_id": "string",
- "observed_at": "string",
- "operation_business_edges": [
- {
- "business_ref": {
- "as_of": "string",
- "display_hint": "string",
- "ref_id": "string",
- "ref_type": "knowledge_network",
- "version": "string"
}, - "observed_at": "string",
- "operation_id": "string",
- "role": "read"
}
], - "operation_id": "string",
- "payload_hash": "string",
- "producer_epoch": 0,
- "producer_id": "string",
- "producer_sequence": 0,
- "producer_stream_id": "string",
- "request_id": "string",
- "span_id": "string",
- "started_at": "string",
- "trace_id": "string"
}{- "durable_ack": true,
- "event_id": "string",
- "ingest_sequence": 0,
- "ingested_at": "string",
- "replayed": true
}Returns the latest immutable assembly revision with precise Claim supports and causal DAG layers. Objective evidence completeness is separate from current-user disclosure completeness; unresolved or unauthorized business refs and their edges are omitted.
| interaction_id required | string Interaction ID |
{- "assembly": {
- "artifact_refs": [
- "string"
], - "business_refs": [
- {
- "disclosure_status": "string",
- "display": {
- "business_path": [
- "string"
], - "controlled_summary": "string",
- "name": "string",
- "resolution_status": "string",
- "source_version": "string"
}, - "technical_ref": {
- "as_of": "string",
- "display_hint": "string",
- "ref_id": "string",
- "ref_type": "knowledge_network",
- "version": "string"
}
}
], - "claims": [
- {
- "adopted_supports": [
- {
- "content_hash": "string",
- "fragment_selector": "string",
- "reason": "string",
- "role": "string",
- "source_interaction_id": "string",
- "source_operation_id": "string",
- "source_revision_id": "string",
- "status": "adopted",
- "target_ref": "string",
- "target_type": "evidence",
- "version": "string"
}
], - "claim": {
- "claim_id": "string",
- "claim_status": "asserted",
- "claim_type": "string",
- "content_artifact_ref": "string",
- "materiality": "material",
- "required_support_roles": [
- "string"
], - "supports": [
- {
- "content_hash": "string",
- "fragment_selector": "string",
- "reason": "string",
- "role": "string",
- "source_interaction_id": "string",
- "source_operation_id": "string",
- "source_revision_id": "string",
- "status": "adopted",
- "target_ref": "string",
- "target_type": "evidence",
- "version": "string"
}
]
}, - "completeness": "not_applicable",
- "partial_reasons": [
- "string"
], - "rejected_supports": [
- {
- "content_hash": "string",
- "fragment_selector": "string",
- "reason": "string",
- "role": "string",
- "source_interaction_id": "string",
- "source_operation_id": "string",
- "source_revision_id": "string",
- "status": "adopted",
- "target_ref": "string",
- "target_type": "evidence",
- "version": "string"
}
], - "unused_evidence_refs": [
- {
- "artifact_ref": "string",
- "as_of": "string",
- "content_hash": "string",
- "evidence_ref": "string",
- "fragment_selector": "string",
- "ref_type": "event",
- "source_interaction_id": "string",
- "source_operation_id": "string",
- "source_revision_id": "string",
- "version": "string"
}
]
}
], - "completeness": "not_applicable",
- "disclosure_partial": true,
- "disclosure_reasons": [
- "string"
], - "event_layers": {
- "property1": 0,
- "property2": 0
}, - "events": [
- {
- "causation_event_ids": [
- "string"
], - "emitted_at": "string",
- "event_id": "string",
- "event_type": "string",
- "layer": 0,
- "observed_at": "string",
- "operation_id": "string",
- "producer_epoch": 0,
- "producer_sequence": 0,
- "producer_stream_id": "string",
- "started_at": "string"
}
], - "evidence_refs": [
- {
- "artifact_ref": "string",
- "as_of": "string",
- "content_hash": "string",
- "evidence_ref": "string",
- "fragment_selector": "string",
- "ref_type": "event",
- "source_interaction_id": "string",
- "source_operation_id": "string",
- "source_revision_id": "string",
- "version": "string"
}
], - "included_event_ids": [
- "string"
], - "operation_business_edges": [
- {
- "business_ref": {
- "disclosure_status": "string",
- "display": {
- "business_path": [
- "string"
], - "controlled_summary": "string",
- "name": "string",
- "resolution_status": "string",
- "source_version": "string"
}, - "technical_ref": {
- "as_of": "string",
- "display_hint": "string",
- "ref_id": "string",
- "ref_type": "knowledge_network",
- "version": "string"
}
}, - "observed_at": "string",
- "operation_id": "string",
- "role": "read"
}
], - "partial_reasons": [
- "string"
], - "unused_evidence_refs": [
- {
- "artifact_ref": "string",
- "as_of": "string",
- "content_hash": "string",
- "evidence_ref": "string",
- "fragment_selector": "string",
- "ref_type": "event",
- "source_interaction_id": "string",
- "source_operation_id": "string",
- "source_revision_id": "string",
- "version": "string"
}
]
}, - "assembly_revision": {
- "artifact_manifest_hash": "string",
- "assembly_completeness": "not_applicable",
- "completion_manifest_version": "string",
- "created_at": "string",
- "included_event_ids": [
- "string"
], - "included_receipt_ids": [
- "string"
], - "interaction_id": "string",
- "parent_revision_id": "string",
- "partial_reasons": [
- "string"
], - "revision_id": "string",
- "revision_no": 0,
- "trigger": "string"
}, - "conversation_id": "string",
- "evidence_status": "not_applicable",
- "execution_status": "active",
- "interaction_id": "string"
}Read-only status for the interaction's current integrity source version. Uses the same canonical authorization as persisted integrity reads; shared-network candidates do not widen that authorization; unauthorized and missing interactions both return 404. Never performs live inspection, claims work, or requeues a retry. No query parameters are accepted. At most 8 attempts over 30 minutes with backoff from 30 seconds to 5 minutes; a new source version schedules a new generation while retaining old retry history. Fixed inspection limits stop the current generation immediately with exhausted/inspection_budget_exceeded (8 MiB per artifact response, 32 MiB or 128 reads per interaction); this is an unknown verdict, not evidence loss. Existing exhausted generations are not requeued or rewritten on upgrade. A succeeded job means a verdict was saved, not that records or business conclusions are complete. Reason may describe exhaustion or source replacement; last_failure_reason retains the last actual failure. Zero timestamps mean no attempt/lease has been recorded.
| interaction_id required | string Canonical interaction ID |
{- "attempts": 0,
- "first_attempt_at": "string",
- "interaction_id": "string",
- "last_attempt_at": "string",
- "last_failure_reason": "string",
- "lease_until": "string",
- "next_attempt_at": "string",
- "reason": "string",
- "source_version": 0,
- "status": "pending"
}Returns desired and effective state separately, the active operation when present, and the current admission-budget measurements. Unavailable budgets return 503 with optional diagnostic details (reason, metric, fields). Requires the existing trace_evidence_configuration:global read permission.
{- "active_operation_id": "string",
- "admission_budget": {
- "contract_version": "string",
- "fresh_until": "string",
- "measurements": [
- {
- "fresh": true,
- "metric": "string",
- "sample_time": "string",
- "source": "string",
- "threshold": 0,
- "value": 0
}
], - "profile": "string",
- "sampled_at": "string"
}, - "desired_state": "enabled",
- "effective_state": "enabled",
- "heartbeat_interval_seconds": 0,
- "kind": "string",
- "last_stable_revision": 0,
- "lease_ttl_seconds": 0,
- "policy_revision": 0
}Requires the existing trace_evidence_configuration:global write permission. Enable requests with unavailable budgets return 503 with optional diagnostic details (reason, metric, fields). The requested state is asynchronous; effective_state reports the last observed runtime state.
Desired state and expected policy revision
| desired_state | string Enum: "enabled" "disabled" "enabling" "disabling" "rolling_back" |
| expected_revision | integer |
{- "desired_state": "enabled",
- "expected_revision": 0
}{- "acknowledgements": [
- {
- "generation": "string",
- "instance_id": "string",
- "queue_disposition": {
- "dropped": 0,
- "exported": 0,
- "unaccounted": 0
}, - "ready": true,
- "revision": 0,
- "state": "ready"
}
], - "coverage_gap": true,
- "desired_state": "enabled",
- "effective_state": "enabled",
- "last_stable_revision": 0,
- "operation": {
- "error_code": "string",
- "expected_revision": 0,
- "id": "string",
- "phase": "pending",
- "requested_state": "enabled"
}, - "revision": 0
}Requires the existing trace_evidence_configuration:global read permission.
| operation_id required | string Configuration operation ID |
{- "error_code": "string",
- "expected_revision": 0,
- "id": "string",
- "phase": "pending",
- "requested_state": "enabled"
}Requests reconciliation of the addressed operation and returns the current configuration snapshot. Requires the existing trace_evidence_configuration:global reconcile permission.
| operation_id required | string Configuration operation ID |
{- "acknowledgements": [
- {
- "generation": "string",
- "instance_id": "string",
- "queue_disposition": {
- "dropped": 0,
- "exported": 0,
- "unaccounted": 0
}, - "ready": true,
- "revision": 0,
- "state": "ready"
}
], - "coverage_gap": true,
- "desired_state": "enabled",
- "effective_state": "enabled",
- "last_stable_revision": 0,
- "operation": {
- "error_code": "string",
- "expected_revision": 0,
- "id": "string",
- "phase": "pending",
- "requested_state": "enabled"
}, - "revision": 0
}On-demand bounded discovery using the current Trace filters and authorization. The service filter itself is excluded. No Span counts or question/result bodies are loaded. Results contain at most 100 canonical names; has_more asks the caller to narrow q. A failed or budget-limited scan never returns a partial catalog.
| from | string Started at or after this RFC3339 timestamp |
| to | string Started at or before this RFC3339 timestamp |
| trace_id | string Exact Trace ID |
| status | string Execution status |
| tool | string Exact root operation |
| error_keyword | string Recorded error summary substring |
| q | string Case-insensitive service-name substring; at most 256 Unicode characters |
| limit | integer Maximum options, 1..100; default 100 |
{- "entries": [
- "string"
], - "has_more": true
}Returns authorized technical Trace summaries. Ordinary pages batch-read missing projection IDs from canonical SQL metadata; unavailable Span counts are explicit. Content/root-filtered pages and dependency failures retain their existing behavior.
| limit | integer Page size, 1..200 |
| cursor | string Opaque pagination cursor |
| trace_id | string Exact trace ID; bypasses list projection scan |
| conversation_id | string Caller-owned conversation ID |
| interaction_id | string One user interaction ID |
| from | string Started at or after this RFC3339 timestamp; omitted means no lower time bound |
| to | string Started at or before this RFC3339 timestamp; omitted means no upper time bound |
| status | string Execution status |
| agent_or_app | string Agent or application |
| service | string Root service name |
| tool | string Root operation name |
| error_keyword | string Substring matched against the recorded error summary |
| keyword | string Case-insensitive substring of trace/request/conversation/interaction IDs, agent/app, root service/operation, or recorded error summary; incomplete searches return a resource error |
{- "entries": [
- {
- "agent_name": "string",
- "agent_or_app": "string",
- "application_principal_id": "string",
- "completed_at": "string",
- "conversation_id": "string",
- "duration_ms": 0,
- "effective_subject_id": "string",
- "error_summary": "string",
- "interaction_id": "string",
- "question_preview": "string",
- "request_id": "string",
- "result_preview": "string",
- "root_operation": "string",
- "root_service": "string",
- "span_count": 0,
- "span_count_status": "string",
- "started_at": "string",
- "status": "string",
- "trace_id": "string"
}
], - "next_cursor": "string",
- "page": 0,
- "page_size": 0,
- "partial": true,
- "partial_reasons": [
- "string"
], - "total": 0,
- "truncated": true
}Returns the authorized trace summary, Span graph, and ordered raw Operation call facts. Operation facts remain visible without Span data; Span nodes remain visible without Operation facts.
| trace_id required | string Trace ID |
{- "graph": {
- "data": {
- "edges": [
- {
- "child_span_id": "string",
- "edge_type": "string",
- "id": "string",
- "parent_span_id": "string"
}
], - "nodes": [
- {
- "duration_nano": 0,
- "end_nano": 0,
- "error_message": "string",
- "kind": "string",
- "name": "string",
- "parent_span_id": "string",
- "service_name": "string",
- "span_id": "string",
- "start_nano": 0,
- "status": "string"
}
]
}, - "duration_nano": 0,
- "page": {
- "edge_count": 0,
- "node_count": 0,
- "truncated": true
}, - "partial": true,
- "partial_reason": [
- "string"
], - "status": "string",
- "trace_id": "string"
}, - "operations": [
- {
- "fact": {
- "attempt": 0,
- "capability_profile": {
- "canonical_tool_name": "string",
- "child_evidence_policy": "string",
- "evidence_contract": "string",
- "execution_role": "string",
- "failure_policy": "string",
- "input_schema_digest": "string",
- "manifest_id": "string",
- "manifest_version": "string",
- "mapper_id": "string",
- "mapper_version": "string",
- "minimum_trace_schema": "string",
- "output_schema_digest": "string",
- "reason": "string",
- "required_trace_fields": [
- "string"
], - "resolution": "string",
- "tool_version": "string"
}, - "conversation_id": "string",
- "error": {
- "byte_length": 0,
- "inline": [
- 0
], - "media_type": "string",
- "mode": "inline",
- "omitted_reason": "string",
- "ref": "string"
}, - "evidence_completion": {
- "expectation": {
- "closed": true,
- "events": [
- {
- "drop_reason": "string",
- "event_id": "string",
- "event_type": "string",
- "payload_hash": "string",
- "producer_id": "string",
- "publish_disposition": "string"
}
], - "version": 0
}, - "original_durability": "pending",
- "original_observed_refs": [
- "string"
], - "original_partial_reasons": [
- "string"
], - "rejected_expectation_hash": "string",
- "rejection_reason": "string"
}, - "finished_at": "string",
- "input": {
- "byte_length": 0,
- "inline": [
- 0
], - "media_type": "string",
- "mode": "inline",
- "omitted_reason": "string",
- "ref": "string"
}, - "interaction_id": "string",
- "operation_id": "string",
- "output": {
- "byte_length": 0,
- "inline": [
- 0
], - "media_type": "string",
- "mode": "inline",
- "omitted_reason": "string",
- "ref": "string"
}, - "parent_operation_id": "string",
- "protocol": "mcp",
- "receipt_id": "string",
- "request_id": "string",
- "retryable": true,
- "source_module": "string",
- "span_id": "string",
- "started_at": "string",
- "status": "ready",
- "tool_name": "string",
- "trace_id": "string"
}, - "partial_reasons": [
- "string"
], - "receipt": {
- "artifact_refs": [
- "string"
], - "attempt": 0,
- "business_refs": [
- {
- "as_of": "string",
- "display_hint": "string",
- "ref_id": "string",
- "ref_type": "knowledge_network",
- "version": "string"
}
], - "causation_event_ids": [
- "string"
], - "conversation_id": "string",
- "evidence_durability": "pending",
- "interaction_id": "string",
- "issued_at": "string",
- "observed_evidence_refs": [
- "string"
], - "operation_id": "string",
- "operation_key": "string",
- "owner": {
- "application_principal_id": "string",
- "delegation_id": "string",
- "effective_subject_id": "string",
- "effective_subject_type": "user"
}, - "partial_reasons": [
- "string"
], - "receipt_id": "string",
- "receipt_status": "pending",
- "request_id": "string",
- "required": true,
- "row_version": 0,
- "schema_version": "string",
- "terminal_at": "string",
- "tool_name": "string",
- "trace_id": "string"
}, - "state": "string"
}
], - "partial": true,
- "partial_reasons": [
- "string"
], - "span_display": {
- "browse_allowed": true,
- "browse_reason": "string",
- "display_limit": 0,
- "first_start_at": "string",
- "last_start_at": "string",
- "loaded_count": 0,
- "raw_record_count": 0,
- "raw_record_limit": 0,
- "sort": "string",
- "total_accuracy": "string",
- "total_count": 0,
- "truncated": true
}, - "summary": {
- "agent_name": "string",
- "agent_or_app": "string",
- "application_principal_id": "string",
- "completed_at": "string",
- "conversation_id": "string",
- "duration_ms": 0,
- "effective_subject_id": "string",
- "error_summary": "string",
- "interaction_id": "string",
- "question_preview": "string",
- "request_id": "string",
- "result_preview": "string",
- "root_operation": "string",
- "root_service": "string",
- "span_count": 0,
- "span_count_status": "string",
- "started_at": "string",
- "status": "string",
- "trace_id": "string"
}
}Requires current global trace access and canonical trace visibility on every page. Signed cursors describe live Span-ID order; pages do not enlarge the graph or claim an exact total.
| trace_id required | string Trace ID |
| cursor | string Signed continuation cursor |
{- "consistency": "string",
- "entries": [
- {
- "duration_nano": 0,
- "end_nano": 0,
- "error_message": "string",
- "kind": "string",
- "name": "string",
- "parent_span_id": "string",
- "service_name": "string",
- "span_id": "string",
- "start_nano": 0,
- "status": "string"
}
], - "has_more": true,
- "next_cursor": "string",
- "sort": "string",
- "trace_id": "string"
}