> ## Documentation Index > Fetch the complete documentation index at: https://docs.checkfu.com/llms.txt > Use this file to discover all available pages before exploring further. # Export consented Session dataset rows > Exports one selected Session trajectory as dataset rows, or a typed refusal. ## OpenAPI ````yaml /openapi.json post /v1/sessions/{id}/trajectories/dataset openapi: 3.1.0 info: title: Checkfu API version: '2026-08-31' description: >- Authentication is declared per operation: API-key, runtime, or connector bearer; Automation signature; bootstrap poll token; or anonymous bootstrap creation and credential-free pairing redemption. Every general Checkfu REST request requires the dated `Checkfu-Version` header (one of: 2026-08-31); 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: permissionAssignments - name: actionPolicies - name: files - name: memoryStores - name: dreams - name: modelCredentials - name: modelRoutingProfiles - name: blueprintInstallations - name: toolSources - name: skills - name: skillSources - name: agentBlueprints - name: skillProposals - name: instructionProposals - name: catalog - name: concepts - name: support - name: bootstrapRequests - name: connections - name: connectionVaults - name: connectionAssignments - name: connectedRuntimes - name: fileTrees - name: collaboration - name: automationGraphs - name: automations - name: actionApprovals - name: standingApprovals - name: workloadReviewPolicies - 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: workEnvironments - name: computers - name: computerScreens - name: computerBrowserObservations - name: computerBrowserActions - name: environments - name: computerHeadlessOperations - name: vaults - name: apiMcp - name: a2a paths: /v1/sessions/{id}/trajectories/dataset: post: tags: - sessionTrajectories summary: Export consented Session dataset rows description: >- Exports one selected Session trajectory as dataset rows, or a typed refusal. The frontier is frozen at the request; it is closed only when a terminal status or archive event sits inside it, and a training export requires that closure plus the admission-frozen learning grant for the requested purpose, unexpired retention, no ZDR, complete attribution and causal coverage, paired tool actions, and no indeterminate governed effect. `checkfu.session-sft` returns conversation rows carrying the quality receipt; turns copied from a forked predecessor are marked not trainable, and each assistant turn says whether its Run holds a model-call receipt. Withheld, non-text, or observed-subagent turns refuse the dataset rather than dropping silently. `checkfu.session-preference` and `checkfu.session-offline-rl` always refuse with named reasons: no typed preference pairs or per-step reward credit exist to export. 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.exportSessionDataset parameters: - name: id in: path schema: $ref: '#/components/schemas/SessionId' required: true - name: checkfu-version in: header schema: type: string enum: - '2026-08-31' required: true requestBody: content: application/json: schema: type: object properties: format: $ref: '#/components/schemas/Union_388' 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: - primary_thread required: - owner_type additionalProperties: false required: - format - selector additionalProperties: false required: true responses: '200': description: Success content: application/json: schema: anyOf: - type: object properties: outcome: type: string enum: - exported format: type: string enum: - checkfu.session-sft dataset: type: object properties: format: type: string enum: - checkfu.session-sft schema_version: type: number enum: - 1 session_id: $ref: '#/components/schemas/SessionId' selector: $ref: '#/components/schemas/Union_386' source_boundary: $ref: '#/components/schemas/SessionSourceBoundary' dataset_lineage_key: type: string records: type: array items: type: object properties: record_id: type: string messages: type: array items: anyOf: - type: object properties: role: type: string enum: - system content: type: string source_event_ids: $ref: '#/components/schemas/Arrays_61' copied_context: type: boolean required: - role - content - source_event_ids - copied_context additionalProperties: false - type: object properties: role: type: string enum: - user content: type: string source_event_ids: $ref: '#/components/schemas/Arrays_61' copied_context: type: boolean required: - role - content - source_event_ids - copied_context additionalProperties: false - type: object properties: role: type: string enum: - assistant content: anyOf: - type: string - type: 'null' tool_calls: type: array items: type: object properties: id: type: string name: type: string arguments: $ref: '#/components/schemas/JsonValue' required: - id - name - arguments additionalProperties: false train: type: boolean model_call_receipt: type: boolean source_event_ids: $ref: '#/components/schemas/Arrays_61' copied_context: type: boolean required: - role - content - tool_calls - train - model_call_receipt - source_event_ids - copied_context additionalProperties: false - type: object properties: role: type: string enum: - tool tool_call_id: type: string content: type: string is_error: anyOf: - type: boolean - type: 'null' source_event_ids: $ref: '#/components/schemas/Arrays_61' copied_context: type: boolean required: - role - tool_call_id - content - is_error - source_event_ids - copied_context additionalProperties: false required: - record_id - messages additionalProperties: false exclusions: type: array items: type: object properties: reason: type: string enum: - surfaced_thinking_excluded - workflow_events_excluded count: type: integer exclusiveMinimum: 0 required: - reason - count additionalProperties: false quality: $ref: '#/components/schemas/Objects_358' receipt: $ref: >- #/components/schemas/SessionDataQualitySourceCoordinates required: - format - schema_version - session_id - selector - source_boundary - dataset_lineage_key - records - exclusions - quality - receipt additionalProperties: false required: - outcome - format - dataset additionalProperties: false - type: object properties: outcome: type: string enum: - refused format: $ref: '#/components/schemas/Union_388' reasons: type: array items: anyOf: - $ref: '#/components/schemas/Union_387' - type: string enum: - source_too_large - source_incomplete - content_unavailable - tool_result_unpaired - trajectory_empty - content_withheld - content_unrepresentable - observed_subagent_content - preference_pairs_unavailable - step_reward_credit_unavailable allOf: - minItems: 1 quality: anyOf: - $ref: '#/components/schemas/Objects_358' - type: 'null' receipt: anyOf: - $ref: >- #/components/schemas/SessionDataQualitySourceCoordinates - type: 'null' required: - outcome - format - reasons - 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 pattern: ^sess_[0-9a-f]{32}$ Union_388: type: string enum: - checkfu.session-sft - checkfu.session-preference - checkfu.session-offline-rl SessionThreadId: type: string pattern: ^sthr_[0-9a-f]{32}$ Union_386: 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 SessionSourceBoundary: anyOf: - type: object properties: lifecycle: type: string enum: - open closing_event_id: type: 'null' closing_event_type: type: 'null' required: - lifecycle - closing_event_id - closing_event_type additionalProperties: false - type: object properties: lifecycle: type: string enum: - closed closing_event_id: $ref: '#/components/schemas/EventId' closing_event_type: type: string enum: - session.status_completed - session.status_failed - session.status_canceled - session.archived required: - lifecycle - closing_event_id - closing_event_type additionalProperties: false description: >- whether the frozen export frontier is closed by a terminal or archived lifecycle event inside it Arrays_61: type: array items: $ref: '#/components/schemas/EventId' allOf: - minItems: 1 JsonValue: description: >- A value in the JSON data model: null, boolean, finite number, string, array, or object. Objects_358: type: object properties: accepted: type: boolean reasons: type: array items: $ref: '#/components/schemas/Union_387' required: - accepted - reasons additionalProperties: false SessionDataQualitySourceCoordinates: type: object properties: schema_version: type: number enum: - 1 session_id: $ref: '#/components/schemas/SessionId' selector: $ref: '#/components/schemas/Union_386' 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 pattern: ^sha256:[0-9a-f]{64}$ capture_policy_digest: type: string 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 pattern: ^sha256:[0-9a-f]{64}$ exported_by: $ref: '#/components/schemas/ApiKeyId' source_boundary: $ref: '#/components/schemas/SessionSourceBoundary' 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 Union_387: 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 WorkspaceId: type: string 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. SessionActorId: type: string pattern: ^sact_[0-9a-f]{32}$ RunId: type: string pattern: ^run_[0-9a-f]{32}$ SessionWorkUnitId: type: string pattern: ^swu_[0-9a-f]{32}$ SessionInteractionId: type: string pattern: ^sint_[0-9a-f]{32}$ EventId: type: string pattern: ^evt_[0-9a-f]{32}$ 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_364' 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 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_387' allOf: - maxItems: 32 Union_364: 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 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.