Import a qualified native continuation capsule

Validates a transferred capsule, its exact bytes, current retention-projector signature, scrub receipt, and signed checkpoint-import target before retaining import custody for this Session. Import does not launch native work; target-harness launch is the separate handoff operation.

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.

POST /v1/sessions/{id}/continuation-capsules/import

Import a qualified native continuation capsule

cURL

curl --request POST \
  --url https://api.checkfu.com/v1/sessions/{id}/continuation-capsules/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'checkfu-version: <checkfu-version>' \
  --header 'idempotency-key: <idempotency-key>' \
  --data '
{
  "session_thread_id": "<string>",
  "target": {
    "importer_id": "<string>",
    "agent_id": "<string>",
    "agent_version_number": 4503599627370495,
    "environment_id": "<string>",
    "environment_snapshot_digest": "<string>",
    "admission_snapshot_digest": "<string>",
    "runtime_tuple_digest": "<string>",
    "adapter_version_identifier": "<string>",
    "driver_version_identifier": "<string>",
    "continuation_schema_identifier": "<string>",
    "platform_identifier": "<string>",
    "model_manifest_digest": "<string>",
    "tool_manifest_digest": "<string>",
    "resource_manifest_digest": "<string>",
    "capture_policy_digest": "<string>",
    "filesystem_digest": "<string>",
    "qualification_receipt": {
      "authority": "server_runtime_tuple_catalog",
      "catalog_entry_id": "<string>",
      "catalog_revision_digest": "<string>",
      "target_digest": "<string>",
      "qualified_capabilities": [],
      "valid_from": "<string>",
      "valid_until": "<string>",
      "receipt_digest": "<string>",
      "signature": {
        "algorithm": "ed25519",
        "key_id": "<string>",
        "statement_digest": "<string>",
        "signature": "<string>"
      }
    }
  },
  "transfer": {
    "format": "checkfu.session-continuation-capsule",
    "schema_version": 1,
    "capsule": {
      "id": "<string>",
      "workspace_id": "<string>",
      "session_id": "<string>",
      "session_thread_id": "<string>",
      "source_actor_id": "<string>",
      "through_sequence": 4503599627370495,
      "source_agent_id": "<string>",
      "source_agent_version_number": 4503599627370495,
      "source_environment_id": "<string>",
      "source_environment_snapshot_digest": "<string>",
      "source_admission_snapshot_digest": "<string>",
      "source_runtime_tuple_digest": "<string>",
      "source_model_manifest_digest": "<string>",
      "source_tool_manifest_digest": "<string>",
      "source_resource_manifest_digest": "<string>",
      "source_capture_policy_digest": "<string>",
      "adapter_version_identifier": "<string>",
      "platform_identifier": "<string>",
      "native_session_id_digest": "<string>",
      "checkpoint_id": "<string>",
      "included_state": [],
      "encryption": {
        "key_reference_digest": "<string>"
      },
      "artifact": {
        "id": "<string>",
        "session_id": "<string>",
        "media_type": "<string>",
        "byte_count": 536870912,
        "content_digest": "<string>",
        "producer_actor_id": "<string>",
        "work_unit_id": "<string>",
        "availability": {
          "availability_type": "retained",
          "custody_digest": "<string>"
        },
        "availability_recorded_at": "<string>",
        "retention": {
          "authority": "server_retention_projector",
          "workspace_id": "<string>",
          "session_id": "<string>",
          "artifact_id": "<string>",
          "byte_count": 536870912,
          "content_digest": "<string>",
          "availability": {
            "availability_type": "retained",
            "custody_digest": "<string>"
          },
          "availability_recorded_at": "<string>",
          "artifact_created_at": "<string>",
          "policy": {
            "mode": "zdr"
          },
          "policy_digest": "<string>",
          "final_expiry": {
            "expiry_type": "at",
            "expires_at": "<string>"
          },
          "erasure_owner": {
            "kind": "workspace",
            "workspace_id": "<string>"
          },
          "erasure_resource": {
            "kind": "<string>",
            "id": "<string>"
          },
          "erasure_envelope_id": "<string>",
          "recorded_at": "<string>",
          "statement_digest": "<string>",
          "signature": {
            "algorithm": "ed25519",
            "key_id": "<string>",
            "statement_digest": "<string>",
            "signature": "<string>"
          }
        },
        "created_at": "<string>"
      },
      "secret_scrub_receipt": {
        "scrub_result": "passed",
        "scrubber_version_identifier": "<string>",
        "inspected_digest": "<string>"
      },
      "compatible_importers": [
        {
          "importer_id": "<string>",
          "target_digest": "<string>",
          "catalog_revision_digest": "<string>"
        }
      ],
      "compatibility_expires_at": "<string>"
    },
    "projection_signature": {
      "algorithm": "ed25519",
      "key_id": "<string>",
      "statement_digest": "<string>",
      "signature": "<string>"
    },
    "content_encoding": "base64",
    "content_base64": "<string>",
    "exported_at": "<string>"
  }
}
'

200

{
  "outcome": "refused",
  "reason": "capsule_absent"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

checkfu-version · enum<string> · required

Available options: 2026-08-29

idempotency-key · string · required

Required string length: 1 - 255

Path Parameters

id · string · required

Pattern: ^sess_[0-9a-f]{32}$

Body

application/json

session_thread_id · string · required

Pattern: ^sthr_[0-9a-f]{32}$

target · object · required

Show child attributes

transfer · object · required

Show child attributes

use_kind · enum<string>

Available options: same_run_recovery, idle_handoff

Response

200

application/json

Success

Option 1

Option 2

outcome · enum<string> · required

Available options: refused

reason · enum<string> · required

Available options: capsule_absent, capsule_unavailable, source_projection_unavailable, secret_scrub_failed, projector_unavailable, target_unqualified, capsule_invalid, capsule_incompatible