Introducing Agents.·Read
Getting StartedKey ConceptsHow-to GuidesCLITrickest SDKSandbox SDKAPI ReferenceChangelog
Stop a sandbox session

Stop a sandbox session

Stops (disposes) the sandbox session identified by sessionId. Disposable model: no FS snapshot; durable state lives in the workspace store.

DELETE/api/sandbox/session
Query parameters
sessionIdstring
agentSessionIdstring
vaultIdstring

Request

curl
curl -X DELETE https://trickest.io/api/sandbox/session \
  -H "Authorization: Bearer $TRICKEST_TOKEN"

Responses

200Sandbox session stopped
successboolean
400Bad Request – validation error or malformed input
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

401Unauthorized – missing or expired token
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

403Forbidden – insufficient permissions
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

429Too Many Requests – rate limited
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

500Internal Server Error
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

PreviousSandboxProvision a sandbox sessionSandboxNextGet sandbox status