API reference / Skills
Write a skill
Writes a skill of the workspace: a new one, or new words for the one with that name. Every teammate can open it. Anyone in the workspace can write one. When a teammate calls it (save_skill), the call waits for a person's approval. A name that a role's own skill has, or a command like stop, is taken.
/api/v1/skillsOther ways to call it
troopy skills saveIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Body
application/jsonname*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, in one or two sentences: every teammate's list of skills shows it
At least 1 characters · At most 1024 characters
text*stringThe steps, in markdown: what to do, in order, and what to check
At least 1 characters · At most 40000 characters
Response
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