> ## Documentation Index > Fetch the complete documentation index at: https://checkfu.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Export a quality-receipted Session trajectory > Exports one actor-, thread-, Run-, work-, or interaction-selected Session trajectory with a deterministic SessionDataQualityReceipt. The body names the consumer and selector; inadequate attribution, consent, causality, content, recovery, or retention is a typed refusal, never a score of zero. Step, artifact, and reward lineage project from persisted attribution coordinates, event families, and graded-evidence events; feedback, preference, consequence, and evaluator-independence lineage stays fail-closed until typed sources exist, so purposes that require them are still refusals. Checkfu support posture: alpha; hosted. Required evidence journey: session-turn. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities. ## OpenAPI ````yaml /openapi.json post /v1/sessions/{id}/trajectories/export openapi: 3.1.0 info: title: Checkfu API version: '2026-08-29' description: >- Authentication is declared per operation: API-key, runtime, or connector bearer; Automation signature; or credential-free pairing redemption. Every general Checkfu REST request requires the dated `Checkfu-Version` header (one of: 2026-08-29); the three MCP JSON-RPC transports use `MCP-Protocol-Version`, A2A uses `A2A-Version`, and the provider OAuth callback carries neither Checkfu header. API keys resolve one Workspace without a request selector; authenticated responses identify it with `Checkfu-Workspace-Id`. servers: - url: https://api.checkfu.com security: - bearerAuth: [] tags: - name: organizations - name: sourceRepositories - name: tenants - name: workspaces - name: principals - name: principalGroups - name: principalAccessCredentials - name: apiKeys - name: agents - name: harnesses - name: harnessRuntime - name: computerProfiles - name: permissionAssignments - name: actionPolicies - name: files - name: memoryStores - name: dreams - name: modelCredentials - name: modelRoutingProfiles - name: blueprintInstallations - name: toolSources - name: skills - name: skillSources - name: agentSources - name: skillProposals - name: instructionProposals - name: catalog - name: concepts - name: support - name: connections - name: connectionVaults - name: connectionAssignments - name: connectedRuntimes - name: projects - name: collaboration - name: automationGraphs - name: automations - name: actionApprovals - name: standingApprovals - name: usage - name: models - name: outcomes - name: budgets - name: billing - name: sessions - name: audit - name: sessionExports - name: runs - name: runnerPools - name: transcripts - name: sessionWatches - name: sessionHandoffs - name: sessionCapsules - name: sessionTrajectories - name: webhookEndpoints - name: integrationGateway - name: agentDeployments - name: workEnvironments - name: computers - name: computerScreens - name: computerBrowserObservations - name: computerBrowserActions - name: environments - name: vaults - name: apiMcp - name: a2a paths: /v1/sessions/{id}/trajectories/export: post: tags: - sessionTrajectories summary: Export a quality-receipted Session trajectory description: >- Exports one actor-, thread-, Run-, work-, or interaction-selected Session trajectory with a deterministic SessionDataQualityReceipt. The body names the consumer and selector; inadequate attribution, consent, causality, content, recovery, or retention is a typed refusal, never a score of zero. Step, artifact, and reward lineage project from persisted attribution coordinates, event families, and graded-evidence events; feedback, preference, consequence, and evaluator-independence lineage stays fail-closed until typed sources exist, so purposes that require them are still refusals. Checkfu support posture: alpha; hosted. Required evidence journey: session-turn. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities. operationId: sessionTrajectories.exportSessionTrajectory parameters: - name: id in: path schema: $ref: '#/components/schemas/SessionId' required: true - name: checkfu-version in: header schema: type: string enum: - '2026-08-29' required: true requestBody: content: application/json: schema: type: object properties: consumer: $ref: '#/components/schemas/Union_403' selector: anyOf: - type: object properties: owner_type: type: string enum: - session required: - owner_type additionalProperties: false - type: object properties: owner_type: type: string enum: - thread session_thread_id: $ref: '#/components/schemas/SessionThreadId' required: - owner_type - session_thread_id additionalProperties: false - type: object properties: owner_type: type: string enum: - actor actor_id: $ref: '#/components/schemas/SessionActorId' required: - owner_type - actor_id additionalProperties: false - type: object properties: owner_type: type: string enum: - run run_id: $ref: '#/components/schemas/RunId' required: - owner_type - run_id additionalProperties: false - type: object properties: owner_type: type: string enum: - work_unit work_unit_id: $ref: '#/components/schemas/SessionWorkUnitId' required: - owner_type - work_unit_id additionalProperties: false - type: object properties: owner_type: type: string enum: - interaction interaction_id: $ref: '#/components/schemas/SessionInteractionId' required: - owner_type - interaction_id additionalProperties: false required: - consumer - selector additionalProperties: false required: true responses: '200': description: Success content: application/json: schema: type: object properties: session_id: $ref: '#/components/schemas/SessionId' selector: $ref: '#/components/schemas/Union_404' consumer: $ref: '#/components/schemas/Union_403' sequences: type: array items: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 allOf: - maxItems: 4096 quality: type: object properties: accepted: type: boolean reasons: type: array items: $ref: '#/components/schemas/Union_405' required: - accepted - reasons additionalProperties: false receipt: $ref: '#/components/schemas/SessionDataQualitySourceCoordinates' required: - session_id - selector - consumer - sequences - quality - receipt additionalProperties: false headers: checkfu-workspace-id: description: The Workspace resolved from the authenticated bearer credential. required: true schema: $ref: '#/components/schemas/WorkspaceId' '400': description: Typed Checkfu wire error content: application/json: schema: $ref: '#/components/schemas/ValidationMalformedError' '401': description: Typed Checkfu wire error content: application/json: schema: type: object required: - error properties: error: type: object required: - type - message - more properties: type: type: string enum: - auth.invalid_key message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#auth-invalid-key description: >- Stable public documentation and remedy for this error type. additionalProperties: false additionalProperties: false '403': description: >- The organization, tenant, or workspace backing this key is administratively disabled. | Deployment governance or retention policy denied the request. content: application/json: schema: anyOf: - type: object required: - error properties: error: type: object properties: type: type: string enum: - auth.disabled_tenancy message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#auth-disabled-tenancy description: >- Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false additionalProperties: false - $ref: '#/components/schemas/PolicyDeniedError' '404': description: >- The requested resource does not exist in the resolved deployment boundary. content: application/json: schema: $ref: '#/components/schemas/ValidationNotFoundError' '429': description: Typed Checkfu wire error headers: retry-after: description: >- Delay in seconds for rate limits or deployment quotas with a known release or UTC reset boundary required: false schema: type: integer minimum: 1 content: application/json: schema: type: object required: - error properties: error: type: object required: - type - message - more properties: type: type: string enum: - budget.exceeded message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#budget-exceeded description: >- Stable public documentation and remedy for this error type. additionalProperties: false additionalProperties: false '500': description: >- An unexpected internal failure occurred; the message contains an opaque incident reference. content: application/json: schema: $ref: '#/components/schemas/RuntimeInternalError' security: - bearerAuth: [] components: schemas: SessionId: type: string allOf: - pattern: ^sess_[0-9a-f]{32}$ Union_403: type: string enum: - memory - sft - preference - offline_rl - evaluation - self_improvement SessionThreadId: type: string allOf: - pattern: ^sthr_[0-9a-f]{32}$ SessionActorId: type: string allOf: - pattern: ^sact_[0-9a-f]{32}$ RunId: type: string allOf: - pattern: ^run_[0-9a-f]{32}$ SessionWorkUnitId: type: string allOf: - pattern: ^swu_[0-9a-f]{32}$ SessionInteractionId: type: string allOf: - pattern: ^sint_[0-9a-f]{32}$ Union_404: anyOf: - type: object properties: owner_type: type: string enum: - session session_id: $ref: '#/components/schemas/SessionId' required: - owner_type - session_id additionalProperties: false - type: object properties: owner_type: type: string enum: - thread session_id: $ref: '#/components/schemas/SessionId' session_thread_id: $ref: '#/components/schemas/SessionThreadId' required: - owner_type - session_id - session_thread_id additionalProperties: false - type: object properties: owner_type: type: string enum: - actor session_id: $ref: '#/components/schemas/SessionId' actor_id: $ref: '#/components/schemas/SessionActorId' required: - owner_type - session_id - actor_id additionalProperties: false - type: object properties: owner_type: type: string enum: - run session_id: $ref: '#/components/schemas/SessionId' run_id: $ref: '#/components/schemas/RunId' required: - owner_type - session_id - run_id additionalProperties: false - type: object properties: owner_type: type: string enum: - work_unit session_id: $ref: '#/components/schemas/SessionId' work_unit_id: $ref: '#/components/schemas/SessionWorkUnitId' required: - owner_type - session_id - work_unit_id additionalProperties: false - type: object properties: owner_type: type: string enum: - interaction session_id: $ref: '#/components/schemas/SessionId' interaction_id: $ref: '#/components/schemas/SessionInteractionId' required: - owner_type - session_id - interaction_id additionalProperties: false Union_405: type: string enum: - learning_disallowed - purpose_not_granted - grant_expired - zdr - retention_expired - redaction_incomplete - source_not_closed - attribution_incomplete - causal_coverage_incomplete - local_sequence_incomplete - action_content_unavailable - consequence_open - feedback_lineage_incomplete - preference_alternatives_missing - evaluator_not_independent - abandoned_attempt_included - external_effect_ambiguous - historical_attribution_unknown - collaboration_fidelity_insufficient SessionDataQualitySourceCoordinates: type: object properties: schema_version: type: number enum: - 1 session_id: $ref: '#/components/schemas/SessionId' selector: $ref: '#/components/schemas/Union_404' source_frontier_sequence: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 terminal_frontier_sequence: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 event_schema_version: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 graph_schema_version: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 projector_version: type: string allOf: - minLength: 1 - maxLength: 1024 source_bundle_digest: type: string allOf: - pattern: ^sha256:[0-9a-f]{64}$ capture_policy_digest: type: string allOf: - pattern: ^sha256:[0-9a-f]{64}$ attribution: $ref: '#/components/schemas/SessionDataQualityCoveredCount' causal_links: $ref: '#/components/schemas/SessionDataQualityCoveredCount' local_sequence: $ref: '#/components/schemas/SessionDataQualityCoveredCount' content: $ref: '#/components/schemas/SessionLearningAbsentContentCensus' worker_recovery_boundaries: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 abandoned_attempt_event_ids: $ref: '#/components/schemas/DistinctSessionQualityAbandonedEvents' duplicate_event_ids: $ref: '#/components/schemas/DistinctSessionQualityDuplicateEvents' ambiguous_external_effect_event_ids: $ref: '#/components/schemas/DistinctSessionQualityAmbiguousEffects' feedback_source_count: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 preference_source_count: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 reward_source_count: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 independent_evaluator_count: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 learning_purposes: $ref: '#/components/schemas/DistinctSessionQualityPurposes' learning_use: type: string enum: - disallowed - allowed learning_authorized_until: anyOf: - $ref: '#/components/schemas/CurrentTimestamp' - type: 'null' retention_mode: type: string enum: - standard - zdr retention_deadline: anyOf: - $ref: '#/components/schemas/CurrentTimestamp' - type: 'null' redaction_state: type: string enum: - not_required - complete - incomplete source_closed: type: boolean claim_citations_complete: type: boolean action_content_complete: type: boolean consequences_closed: type: boolean preference_alternatives_complete: type: boolean dataset_lineage_key: type: string allOf: - pattern: ^sha256:[0-9a-f]{64}$ exported_by: $ref: '#/components/schemas/ApiKeyId' collaboration: $ref: '#/components/schemas/DistinctSessionCollaborationCapabilityAxes' exclusion_reasons: $ref: '#/components/schemas/DistinctSessionDataQualityExclusions' required: - schema_version - session_id - selector - source_frontier_sequence - terminal_frontier_sequence - event_schema_version - graph_schema_version - projector_version - source_bundle_digest - capture_policy_digest - attribution - causal_links - local_sequence - content - worker_recovery_boundaries - abandoned_attempt_event_ids - duplicate_event_ids - ambiguous_external_effect_event_ids - feedback_source_count - preference_source_count - reward_source_count - independent_evaluator_count - learning_purposes - learning_use - learning_authorized_until - retention_mode - retention_deadline - redaction_state - source_closed - claim_citations_complete - action_content_complete - consequences_closed - preference_alternatives_complete - dataset_lineage_key - collaboration - exclusion_reasons additionalProperties: false WorkspaceId: type: string allOf: - pattern: ^wrkspc_[0-9a-f]{32}$ ValidationMalformedError: type: object properties: error: type: object properties: type: type: string enum: - validation.malformed message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#validation-malformed description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- The request could not be decoded or violated a declared input constraint. PolicyDeniedError: type: object properties: error: type: object properties: type: type: string enum: - policy.denied message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#policy-denied description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: Deployment governance or retention policy denied the request. ValidationNotFoundError: type: object properties: error: type: object properties: type: type: string enum: - validation.not_found message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#validation-not-found description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- The requested resource does not exist in the resolved deployment boundary. RuntimeInternalError: type: object properties: error: type: object properties: type: type: string enum: - runtime.internal message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#runtime-internal description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- An unexpected internal failure occurred; the message contains an opaque incident reference. SessionDataQualityCoveredCount: type: object properties: covered: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 total: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 required: - covered - total additionalProperties: false SessionLearningAbsentContentCensus: type: array items: type: object properties: content_class: type: string enum: - human_input - agent_output - surfaced_thinking - model_io - tool_io - workflow - environment - computer - native_transcript - reward_evidence availability: type: string enum: - content - digest_only - structural_only - not_captured - zdr_omitted - expired - shredded - redacted - truncated - flattened - opaque - not_applicable count: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 required: - content_class - availability - count additionalProperties: false allOf: - minItems: 10 - maxItems: 110 DistinctSessionQualityAbandonedEvents: type: array items: $ref: '#/components/schemas/EventId' allOf: - maxItems: 4096 DistinctSessionQualityDuplicateEvents: type: array items: $ref: '#/components/schemas/EventId' allOf: - maxItems: 4096 DistinctSessionQualityAmbiguousEffects: type: array items: $ref: '#/components/schemas/EventId' allOf: - maxItems: 4096 DistinctSessionQualityPurposes: type: array items: $ref: '#/components/schemas/Union_300' allOf: - maxItems: 6 CurrentTimestamp: type: string allOf: - maxLength: 24 - pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ description: A canonical UTC ISO-8601 timestamp with millisecond precision. ApiKeyId: type: string allOf: - pattern: ^akey_[0-9a-f]{32}$ DistinctSessionCollaborationCapabilityAxes: type: array items: $ref: '#/components/schemas/SessionCollaborationCapabilityEvidence' allOf: - minItems: 3 - maxItems: 3 DistinctSessionDataQualityExclusions: type: array items: $ref: '#/components/schemas/Union_405' allOf: - maxItems: 32 EventId: type: string allOf: - pattern: ^evt_[0-9a-f]{32}$ Union_300: type: string enum: - memory_curation - sft - preference - offline_rl - evaluation - self_improvement SessionCollaborationCapabilityEvidence: type: object properties: axis: type: string enum: - subagents - teams - workflows capability: type: string enum: - unsupported - declared - qualified - unknown activity: type: string enum: - not_observed - complete - structured - observed - flattened - opaque evidence_event_ids: $ref: '#/components/schemas/DistinctSessionCollaborationCapabilityEvents' evidence_actor_lineage_ids: $ref: >- #/components/schemas/DistinctSessionCollaborationCapabilityActorLineages evidence_work_unit_ids: $ref: '#/components/schemas/DistinctSessionCollaborationCapabilityWorkUnits' loss_reasons: $ref: '#/components/schemas/DistinctSessionCollaborationLossReasons' required: - axis - capability - activity - evidence_event_ids - evidence_actor_lineage_ids - evidence_work_unit_ids - loss_reasons additionalProperties: false DistinctSessionCollaborationCapabilityEvents: type: array items: $ref: '#/components/schemas/EventId' allOf: - maxItems: 64 DistinctSessionCollaborationCapabilityActorLineages: type: array items: $ref: '#/components/schemas/SessionActorId' allOf: - maxItems: 64 DistinctSessionCollaborationCapabilityWorkUnits: type: array items: $ref: '#/components/schemas/SessionWorkUnitId' allOf: - maxItems: 64 DistinctSessionCollaborationLossReasons: type: array items: type: string enum: - no_stable_identity - no_parent_correlation - lifecycle_only - content_unavailable - transport_loss allOf: - maxItems: 5 securitySchemes: bearerAuth: type: http scheme: bearer ````