API reference / Skills
Turn a skill on or off
Off, no teammate sees the skill or opens it. Needs an owner or admin.
/api/v1/skills/{name}Other ways to call it
troopy skills updateIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Path parameters
name*stringThe skill's name, like cold-email: a message that starts with /cold-email asks a teammate to use it
At most 64 characters
Body
application/jsonenabled*booleanResponse
200 · application/jsondata*object12 properties
name*stringThe skill's name, like cold-email: a message that starts with /cold-email asks a teammate to use it
At most 64 characters
description*stringWhen to use it: what every teammate's list of skills shows
enabled*booleanOff: no teammate sees it or opens it
source*enum<string>person: a person wrote it. teammate: a teammate proposed it, and a person approved it. taught: a person taught it by doing the task once
personteammatetaught
author*objectWho made it: a person, an API key, or the teammate whose proposal a person approved
3 properties
type*enum<string>personagentapi
id*stringname*stringteammate*string | nullA taught skill: the handle of the teammate whose browser showed it
uses*integerHow many runs used it: a person asked for it with /name, or a teammate opened it
lastUsedAt*string | nullWhen a run last used it. null when no run did
createdAt*stringISO 8601 date and time
updatedAt*stringISO 8601 date and time
text*stringThe steps, in markdown
updatedBy*objectWho changed it last
3 properties
type*enum<string>personagentapi
id*stringname*string