RErender
Sandboxes

Create a connect token for a sandbox run

Changed on

Mint a short-lived, capability-scoped connect token that authorizes a single run operation against the specified sandbox. The response contains the sandbox URI where the caller sends the command with the token as a bearer credential.

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

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

Request

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

Parameters

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

Request body

commandstring

Command text for the sandbox event timeline.

Response

Connect token minted.

executionIdstring required

Identifier for this execution.

tokenstring required

Short-lived bearer token authorizing exactly this operation against the sandbox.

uristring uri required

The sandbox-proxy endpoint to invoke.

methodstring required

HTTP method to use against uri.

expiresAtstring date-time required

When token stops being valid. Start the run before this time.

Example response

{
  "executionId": "exe-cph1rs3idesc73a2b2mg",
  "uri": "https://sbx-abc123.oregon.sandbox.onrender.com/runs/stream",
  "method": "POST",
  "expiresAt": "2026-07-10T12:00:00Z"
}

Changes