> ## 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 a Session as Harbor ATIF > Exports one Session conversation (the Session, a thread, or the primary thread) as an ATIF-v1.8 trajectory pinned to the Harbor 0.23.0 schema, frozen at… ## OpenAPI ````yaml /openapi.json post /v1/sessions/{id}/trajectories/atif 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: managedTools - 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/atif: post: tags: - sessionTrajectories summary: Export a Session as Harbor ATIF description: >- Exports one Session conversation (the Session, a thread, or the primary thread) as an ATIF-v1.8 trajectory pinned to the Harbor 0.23.0 schema, frozen at the request. Observed harness subagents become embedded trajectories linked from their spawning tool call where the harness exposed it; turns copied from a forked predecessor are `is_copied_context`; model-call counts and token metrics come only from usage receipts in the same Run and are left unknown otherwise. A report names the pinned upstream, the source boundary, every counted loss, and the separate SFT eligibility verdict. ATIF is an interchange view: it does not make the Session natively resumable, restore files, or define an RL environment, and exporting it grants no learning use. 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.exportSessionAtif 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: selector: $ref: '#/components/schemas/Union_394' required: - selector additionalProperties: false required: true responses: '200': description: Success content: application/json: schema: anyOf: - type: object properties: outcome: type: string enum: - exported trajectory: type: object properties: schema_version: type: string enum: - ATIF-v1.8 session_id: anyOf: - type: string - type: 'null' trajectory_id: anyOf: - type: string - type: 'null' agent: type: object properties: name: type: string version: type: string model_name: anyOf: - type: string - type: 'null' tool_definitions: anyOf: - type: array items: type: object - type: 'null' extra: $ref: '#/components/schemas/Objects_368' required: - name - version additionalProperties: false steps: type: array items: type: object properties: step_id: type: integer minimum: 1 timestamp: anyOf: - type: string - type: 'null' source: type: string enum: - system - user - agent model_name: anyOf: - type: string - type: 'null' message: type: string reasoning_content: anyOf: - type: string - type: 'null' tool_calls: anyOf: - type: array items: type: object properties: tool_call_id: type: string function_name: type: string arguments: type: object extra: $ref: '#/components/schemas/Objects_368' required: - tool_call_id - function_name - arguments additionalProperties: false - type: 'null' observation: anyOf: - type: object properties: results: type: array items: type: object properties: source_call_id: type: string content: type: string subagent_trajectory_ref: type: array items: $ref: >- #/components/schemas/AtifSubagentTrajectoryRefResolvable extra: $ref: '#/components/schemas/Objects_368' additionalProperties: false required: - results additionalProperties: false - type: 'null' metrics: anyOf: - type: object properties: prompt_tokens: type: integer completion_tokens: type: integer cached_tokens: type: integer cost_usd: type: number extra: $ref: '#/components/schemas/Objects_368' additionalProperties: false - type: 'null' is_copied_context: anyOf: - type: boolean - type: 'null' llm_call_count: anyOf: - type: integer minimum: 0 - type: 'null' extra: $ref: '#/components/schemas/Objects_368' required: - step_id - source - message additionalProperties: false allOf: - minItems: 1 notes: anyOf: - type: string - type: 'null' final_metrics: anyOf: - type: object properties: total_prompt_tokens: type: integer total_completion_tokens: type: integer total_cached_tokens: type: integer total_cost_usd: type: number total_steps: type: integer minimum: 0 extra: $ref: '#/components/schemas/Objects_368' additionalProperties: false - type: 'null' continued_trajectory_ref: anyOf: - type: string - type: 'null' extra: $ref: '#/components/schemas/Objects_368' subagent_trajectories: anyOf: - type: array items: type: object - type: 'null' required: - schema_version - agent - steps additionalProperties: false report: type: object properties: exporter_version: type: string enum: - checkfu.session-atif/1 schema_version: type: string enum: - ATIF-v1.8 upstream: type: object properties: package: type: string enum: - harbor version: type: string enum: - 0.23.0 wheel: type: string enum: - harbor-0.23.0-py3-none-any.whl wheel_sha256: type: string enum: - >- 8747400dbb2a5e2298e1338e17e88eba38433c0433fd700f34d1a9021bba5c37 required: - package - version - wheel - wheel_sha256 additionalProperties: false source_boundary: $ref: '#/components/schemas/SessionSourceBoundary' through_sequence: type: integer positions: type: integer represented_positions: type: integer steps: type: integer copied_context_steps: type: integer model_call_steps: type: integer subagent_trajectories: type: integer losses: type: array items: type: object properties: reason: type: string enum: - content_unavailable - attribution_unknown - multimodal_content_omitted - content_withheld - orphan_tool_result - orphan_reasoning - compaction_summary_unavailable - handoff_rebuild_context_unavailable - delegation_edge_unpersisted - subagent_spawn_call_unknown - subagent_start_unobserved - non_object_arguments_wrapped - unattached_usage_receipt - event_family_not_represented count: type: integer required: - reason - count additionalProperties: false sft_eligibility: anyOf: - type: object properties: accepted: type: boolean enum: - false reasons: type: array items: $ref: '#/components/schemas/Union_392' not_evaluated: type: string enum: - selection_exceeds_receipt_bound required: - accepted - reasons - not_evaluated additionalProperties: false - $ref: '#/components/schemas/Objects_367' native_resume: type: string enum: - not_supported restores_files: type: boolean enum: - false rl_environment: type: boolean enum: - false required: - exporter_version - schema_version - upstream - source_boundary - through_sequence - positions - represented_positions - steps - copied_context_steps - model_call_steps - subagent_trajectories - losses - sft_eligibility - native_resume - restores_files - rl_environment additionalProperties: false required: - outcome - trajectory - report additionalProperties: false - type: object properties: outcome: type: string enum: - refused reasons: type: array items: type: string enum: - source_too_large - source_incomplete - trajectory_empty allOf: - minItems: 1 required: - outcome - reasons 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_394: 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 Objects_368: type: object AtifSubagentTrajectoryRefResolvable: type: object properties: trajectory_id: anyOf: - type: string - type: 'null' session_id: anyOf: - type: string - type: 'null' trajectory_path: anyOf: - type: string - type: 'null' extra: $ref: '#/components/schemas/Objects_368' 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 Union_392: 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 Objects_367: type: object properties: accepted: type: boolean reasons: type: array items: $ref: '#/components/schemas/Union_392' required: - accepted - reasons additionalProperties: false 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. SessionThreadId: type: string pattern: ^sthr_[0-9a-f]{32}$ EventId: type: string pattern: ^evt_[0-9a-f]{32}$ securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.