Skip to content
Console
Menu

Alerts and status pages

App store purchases

Credits

Knowledge

KV

Notifications

Organizations

Storage

Workflows

API reference

Getting Started

Authentication

KV Store

sylphx agents transfers

Every sylphx agents transfers command: its argument, its flags and a run line.

The transfers commands of Sylphx Agents, as the CLI spells them: the same calls as the transfers API page, typed for the shell. Install, sign in and the grammar 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

Shell
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

Flags

FlagTypeWhat it does
--operation-idstringPermanent caller identity; exact retries return the original transfer. Required.
--manifestjsonsylphx.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-sha256stringSHA-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

Shell
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

#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

Shell
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

Flags

FlagTypeWhat it does
--indexintZero-based declared part index. Required.
--datastringBase64 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

Shell
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

#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

Shell
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

Flags

FlagTypeWhat it does
--receipt-sha256stringExact read-back receipt durably recorded by the original source adapter. Required.
--source-fence-sha256stringThe 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

Shell
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