API reference / Account
Revoke an invite of an accountant
Revokes an invite to be the accountant of the company of the key, before someone accepts it. Its link stops working. Needs an owner or admin.
delete
/api/v1/company/accountants/invites/{id}Other ways to call it
CLI
troopy company revoke-accountant-inviteMCP toolNone. Call it over REST or with the CLI.
Rate limit30 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.Path parameters
id*stringA 24-character id
Response
200 · application/jsondata*object2 properties
accountants*array<object>The accountants of the company, oldest first
5 properties
id*stringA 24-character id
name*stringemail*stringrole*enum<string>Role in the company. Owners and admins reach every workspace in it, and manage its people. A member reaches only the workspaces that someone invited it into. An accountant reaches no workspace: it reads the Portfolio and the reports of the company in the app, and changes nothing
owneradminmemberaccountant
joinedAt*stringISO 8601 date and time
invites*array<object>The invites that wait, newest first
4 properties
id*stringA 24-character id
email*stringinvitedBy*stringThe name of the person who sent it
expiresAt*stringISO 8601 date and time
Errors
400 invalid_inputFix the field named in detail. Each operation's schema is in /api/v1/openapi.json.
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 a company owner or admin.
404 not_foundCheck the path and any id in it. Every operation is listed in /api/v1/openapi.json.
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.