API reference / Troop
Finish teaching a task
study sends the recording to the teammate: a conversation opens with it and it drafts a skill (then GET shows it ready). approve saves the reviewed skill, with your edits, as a skill of the workspace that every teammate can use (GET /skills); its name can't be one a skill has already. discard drops the recording or the draft. Needs an owner or admin.
/api/v1/agents/{handle}/teachOther ways to call it
troopy teach updateIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Path parameters
handle*stringThe teammate's handle, like chief
At most 40 characters
Body
application/jsonaction*enum<string>studyapprovediscard
skillobjectFor approve: the skill as reviewed
3 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
At least 1 characters · At most 1024 characters
text*stringThe steps, as a numbered markdown list
At least 1 characters · At most 40000 characters
Response
200 · application/jsondata*object9 properties
id*stringA 24-character id
agent*stringThe teammate's handle
goal*stringWhat the person said they would show
status*enum<string>recordingstudyingreadysaveddiscardedfailed
steps*integerSteps recorded: visits, clicks, typing, Enter
draft*object | nullThe skill it drafted, once ready
3 properties
name*stringdescription*stringWhen to use it
text*stringThe steps, in markdown
threadId*string | nullThe conversation it studies the recording in
error*string | nullcreatedAt*string