API reference / Vault
Change a vault item
Changes an item's name, tags, expiry or values: send only what changes; a value set to null is cleared (a custom field's is removed). The old value of a concealed field is kept in its history. Its collection and urls change in the app only.
/api/v1/vault/items/{id}Other ways to call it
troopy vault updateIdempotency-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
Body
application/jsonnamestringAt least 1 characters · At most 200 characters
tagsarray<string>At most 10 items
environmentenum<string> | nulltestlive
expiresAtstring | nullvaluesobjectValues by key; null clears one
customarray<object>Fields of your own, added after the kind's
At most 20 items
4 properties
label*stringAt least 1 characters · At most 60 characters
value*stringAt most 20000 characters
concealedbooleanDefault true
typeenum<string>textemailurlpasswordmultiline
Default "text"
Response
200 · application/jsondata*object18 properties
id*stringA 24-character id
collection*object2 properties
id*stringA 24-character id
name*stringkind*enum<string>loginapi_keysecretnotecard
name*stringtags*array<string>urls*array<string>Logins: the pages it signs in on. API keys: the service's address
sites*array<string>The domains of urls: where a teammate may use a login
environment*enum<string> | nullAPI keys: test or live
testlive
expiresAt*string | nullfields*array<object>7 properties
key*stringStable: references (troopy://vault/<item>/<key>) name it
label*stringtype*enum<string>textemailurlpasswordtotpmonthmultiline
concealed*booleanConcealed values never leave through the API; people see them in the app after unlocking
value*string | nullThe value when it isn't concealed; null when concealed or empty
hint*string | nullA long key's or card number's last four characters
set*booleanWhether it has a value
status*enum<string>unconfirmed: a login a teammate made signing up, until it signs in with it or a person confirms it
activeunconfirmed
importedFrom*enum<string> | null1passwordbitwardenlastpasschrome
createdBy*objectWho added it: a person, a teammate (type agent) or an API key
3 properties
type*enum<string>personagentapi
id*stringname*stringupdatedBy*objectWho wrote it
3 properties
type*enum<string>personagentapi
id*stringname*stringlevel*enum<string>What you may do with it
viewusemanage
createdAt*stringISO 8601 date and time
updatedAt*stringISO 8601 date and time
lastUsedAt*string | null