API reference / Vault
List vault collections
The workspace's vault collections you can reach, each with who may use it and what you may do in it. Every item lives in one. Collections and who reaches them are set in the app.
get
/api/v1/vault/collectionsOther ways to call it
CLI
troopy vault collectionsMCP tool
troopy_list_vault_collectionsRate limit60 calls in 60 seconds, for each key
Response
200 · application/jsondata*array<object>10 properties
id*stringA 24-character id
name*stringeveryone*enum<string> | nullWhat everyone in the workspace may do in it
viewusemanage
people*array<object>3 properties
id*stringA 24-character id
name*stringlevel*enum<string>viewusemanage
teammates*array<object>Teammates that may use its logins
2 properties
handle*stringname*stringisDefault*booleanreceivesSignups*booleanWhere logins teammates make signing up go
madeBy*object | nullA teammate's own collection of the logins it made
2 properties
handle*stringname*stringlevel*enum<string>What you may do in it
viewusemanage
items*integerErrors
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.
429 rate_limitedWait the number of seconds in Retry-After, then retry.