---
# @generated by sylphx-gen. Do not edit.
title: "sylphx agents transfers"
description: "The sylphx agents transfers commands of Sylphx Agents: every verb, with its argument, its flags and a run line."
type: reference
product: agents
summary: "Every sylphx agents transfers command: its argument, its flags and a run line."
updated: 2026-09-28
nav: false
---

The `transfers` commands of Sylphx Agents, as the CLI spells them: the same
calls as [the `transfers` API page](/docs/api/transfers), typed for the
shell. [Install, sign in and the grammar](/docs/cli) are on the CLI index.

## begin

Stages a uniquely identified source epoch on an empty idle Session. The source adapter must already hold its durable one-writer fence.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx agents transfers begin orgs/acme/projects/shop/envs/production/agent_sessions/agent-session
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/transfers:begin` · scope `agents:sessions` · effect `write` · [Request, response and examples](/docs/api/transfers/begin)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--operation-id` | `string` | Permanent caller identity; exact retries return the original transfer. Required. |
| `--manifest` | `json` | sylphx.agents.session-continuity.v1 manifest. At most 256 parts of 256 KiB, and 64 MiB overall. Source epoch must be a positive signed int64. Required. |
| `--source-fence-sha256` | `string` | SHA-256 attestation of the original storage's durable writer marker. Required. |

## get

Returns hashes and original/destination mappings, never private payload.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx agents transfers get orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/transfers/transfer
```

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/transfers/transfer` · scope `agents:sessions` · effect `read` · [Request, response and examples](/docs/api/transfers/get)

## write-part

Stores at most 256 KiB of exact bytes under its declared part digest. An acknowledgement loss can repeat the identical part without mutation.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx agents transfers write-part orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/transfers/transfer
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/transfers/transfer:writePart` · scope `agents:sessions` · effect `write` · [Request, response and examples](/docs/api/transfers/write_part)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--index` | `int` | Zero-based declared part index. Required. |
| `--data` | `string` | Base64 on the JSON wire; exact binary bytes, at most 256 KiB decoded. Required. The value is never returned. |

## finalize

Re-reads ordered parts, checks the whole snapshot and validates the portable state. An unknown effect stays held; this call never executes.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx agents transfers finalize orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/transfers/transfer
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/transfers/transfer:finalize` · scope `agents:sessions` · effect `write` · [Request, response and examples](/docs/api/transfers/finalize)

## adopt

After the source durably records the exact verified receipt under its writer fence, atomically projects conserved state without starting a turn. Unknown outcomes or incompatible pinned model context remain held.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx agents transfers adopt orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/transfers/transfer
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/transfers/transfer:adopt` · scope `agents:sessions` · effect `write` · [Request, response and examples](/docs/api/transfers/adopt)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--receipt-sha256` | `string` | Exact read-back receipt durably recorded by the original source adapter. Required. |
| `--source-fence-sha256` | `string` | The original one-writer marker attestation bound at Begin. Required. |

## abort

Releases only a destination that has not adopted source state. Immutable source bytes/epoch remain retained; source writer release is app-owned.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx agents transfers abort orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/transfers/transfer
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/transfers/transfer:abort` · scope `agents:sessions` · effect `write` · [Request, response and examples](/docs/api/transfers/abort)