Mint a connect token for a sandbox file transfer

Create a short-lived connect token for a file upload or download. Transfer the file directly to or from the URL in the response, using the token as the bearer token. The token authorizes only the specified sandbox, operation, and path. Its expiration time is returned in expiresAt.

Use application/octet-stream for a single file or application/x-tar for a directory archive. For gzip compression, also set Content-Encoding: gzip. Directory downloads return application/x-tar with Content-Encoding: gzip.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
^sbx-[0-9a-v]{25}$

The ID of the sandbox.

string
enum
required

The file transfer operation to authorize. Use upload to send a file or tar archive with HTTP PUT, or download to retrieve a file or directory archive with HTTP GET.

Allowed:
Query Params
string

The ID of the workspace the sandbox belongs to. If provided, it must match the sandbox's workspace. If omitted, Render determines the workspace from the sandbox ID.

string
required

The file or directory path the token authorizes. For archive uploads, this is the directory to extract into. For downloads, it is the file or directory to retrieve.

Relative paths are resolved from the image's WORKDIR, or the home directory if no WORKDIR is set. Use . for that working directory. Absolute paths are resolved from the sandbox filesystem root.

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json