API reference / Computer
Disconnect the AI plan
Signs the AI plan out of the workspace's computer and removes its key or tokens there. The teammates of the workspace stop until it is connected again. Needs an owner or admin.
/api/v1/computer/connectionOther ways to call it
troopy ai disconnecttroopy_disconnect_aiIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Query parameters
planstringWhich of the organization's AI plans, by id. The default plan when left out
Response
200 · application/jsondata*object11 properties
provider*enum<string> | nullclaudechatgptgeminigrokcopilotopenrouterzaikimiminimaxqwenanthropicopenaicursor
method*enum<string> | nullHow the plan signs in: an API key; a code to approve on the provider's site (device_code); or signing in at the provider's site and pasting back the code it shows (paste_code). Null when Troopy can't connect the plan yet
api_keydevice_codepaste_code
status*enum<string>pending: waiting for someone to approve userCode at verificationUrl (device_code), or to sign in at verificationUrl and send the code back (paste_code)
nonependingconnectedfailed
userCode*string | nullThe code to enter at verificationUrl. Shown to owners and admins only
verificationUrl*string | nullexpiresAt*string | nullWhen userCode stops working
keyHint*string | nullThe last four characters of the API key in use
connectedAt*string | nullerror*string | nullWhy the last attempt failed, in words to show people
limitedUntil*string | nullOut of usage until then: teammates use the next plan down the list meanwhile
lapsedAt*string | nullSince when the sign-in lapsed and the plan's CLI couldn't renew it. Sign the plan in again (POST /computer/connection). Null while the sign-in is fresh