RErender
Sandboxes

Mint a connect token for a sandbox file transfer

Changed on

Mint a short-lived, capability-scoped connect token that authorizes a single file upload or download against the sandbox, and return the sandbox-proxy endpoint to invoke with it. The caller streams the file bytes directly to (or from) that endpoint with the token as a bearer credential. application/octet-stream carries a single file and application/x-tar a directory archive, with compression carried separately by Content-Encoding: gzip in either direction; directory downloads return application/x-tar with Content-Encoding: gzip. The token is bound to this sandbox, operation, and path, and expires shortly after issuance.

409 with code: sandbox_group_suspended if the sandbox group is suspended.

post/sandboxes/{sandboxId}/files/{operation}/token

Request

  • Base URL
    https://api.render.com/v1
  • Auth
    HTTP bearer

Query parameters

pathstring required

Path in the sandbox this token authorizes. A relative path resolves within the sandbox's working directory, which is the image's WORKDIR or, when the image sets none, the home directory ("." is the working directory itself); an absolute path addresses the sandbox filesystem root. For an archive upload, the extraction root; for a download, the file or directory to fetch.

Parameters

#/paths/~1sandboxes~1{sandboxId}/get/parameters/0 (unresolved $ref)

Response

Connect token minted.

Schema required(unresolved $ref)

Changes