sandboxes

End a session now. Its next request is refused; revoking one already ended is harmless.

post/v1/sandboxes/{id}/sessions/{sessionId}:revoke

Request

  • Base URL: https://api.withruntime.com
  • URL: https://api.withruntime.com/v1/sandboxes/{id}/sessions/{sessionId}:revoke
  • Auth: HTTP bearer

Path parameters

idstring required

Resource identifier (UUID).

sessionIdstring required

Resource identifier (UUID).

Headers

Idempotency-Keystring

Replaying the same key with the same request within 24 hours returns the first result and never repeats the effect. A refusal is not kept: a request refused before it ran (no_capacity, busy, a limit) runs afresh when sent again with its key. The SDKs send one automatically; the server makes one when absent and returns it in the idempotency-key response header.

Response

Success

idstring uuid
sandboxIdstring uuid
namestring nullable
originsstring[]
createdBystring

The agent whose key made it; the session acts as it.

createdAtstring date-time
expiresAtstring date-time
revokedAtstring date-time nullable
state'active' | 'expired' | 'revoked'

Changes

No recorded changes to this operation across all 1 revision of this API.