Sign Up

Volumes

POST
/volumes/{volumeId}/pull

Pull only; there is no public commit operation. Retain requestId across retries. Definitive results replay within the current session. A pending, unavailable or rate-limited result is retried only by a call with waitMs above zero; waitMs 0 returns the last outcome (a rate limit with its remaining delay) and queues nothing. An elapsed wait or disconnected caller does not cancel accepted work. An unregistered attachment returns a conflict; replay is not durable across daemon restart. Windows returns UNSUPPORTED_OPERATION.

Path Parameters

volumeId*string

Attached volume ID (1–128 ASCII letters, digits, underscores or hyphens).

Request Body

application/json
  1. body
requestId*string

Caller-generated identity, retained across retries (1–128 ASCII letters, digits, underscores or hyphens). Replay is scoped to the active session.

Match^[A-Za-z0-9_-]+$
Length1 <= length <= 128
waitMs?integer

Maximum HTTP wait in milliseconds. Expiry does not cancel accepted work. Omitted means 30000. Zero submits a new request or retrieves a known one without retrying it; only a wait above zero retries a retryable result.

Formatint64
Range0 <= value <= 30000
Default30000

Response Body

Pulled or unchanged.

application/json
  1. response
manifestId*|

Applied manifest for pulled, observed manifest for unchanged (possibly null for a never-committed volume), null for pending. Unchanged does not assert that the local attachment is clean.

requestId*string

The caller's stable request identity, including on elapsed waits.

status*PullVolumeStatus
Value in"pulled""unchanged""pending"
curl -X POST 'http://sandbox:2280/volumes/string/pull' \  -H 'Content-Type: application/json' \  -d '{  "requestId": "string"}'
{  "manifestId": "string",  "requestId": "string",  "status": "pulled"}