Skip to main content
TroopyDocs
Open Troopy
Troopy

API reference / Computer

Reset setup

Deletes the workspace's computer and everything on it, with every sign-in there, so its setup launches it again. The organization's AI plans stay. Cannot be undone. Needs an owner or admin.

delete/api/v1/computer

Authorization

HeaderAuthorization: Bearer <API key>
Or the headerX-API-Key: <API key>
API keyMake one in Troopy under Settings > API keys. It acts as you, in its workspace.

Other ways to call it

CLItroopy computer reset
MCP toolNone. Call it over REST or with the CLI.
Rate limit5 calls in 60 seconds, for each key
RetriesSend an Idempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.

Response

200 · application/json
data*object
1 properties
reset*true

Errors

401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
409 conflictThis Idempotency-Key was used for a different request, or that request is still running. Use a new key for a new request.
429 rate_limitedWait the number of seconds in Retry-After, then retry.