SIsignadot
Sandboxes

Explain sandbox status

Changed on

Returns a sandbox status explanation. In the default mode (mode=explain), generates a natural-language explanation using an LLM fed with cluster context. When mode=context, returns the assembled LLM messages (system prompt + user context) without calling the LLM. Both modes require the sandbox explain AI feature to be enabled, otherwise they return 403 (the assembled context contains sandbox metadata and is itself sensitive).

get/orgs/{orgName}/sandboxes/{sandboxName}/status/explain

Request

  • Base URL
    https://api.signadot.com/api/v2
  • Auth
    API key in header signadot-api-key

Path parameters

orgNamestring required

Signadot Org Name

sandboxNamestring required

Sandbox Name

Query parameters

mode'explain' | 'context'

Response mode: 'explain' (default) calls the LLM, 'context' returns raw LLM messages

Response

OK

explanationstring

Explanation is a natural-language explanation of why the sandbox is in its current state and what, if anything, the user can do. Only present when mode=explain.

mode'explain' | 'context'

Changes