API reference / Troop
Teach a teammate a task
Starts recording a task a person is about to do once in the teammate's own browser on the workspace's computer: its browser comes to the front, then page visits, clicks, typing and Enter are recorded, never passwords, one-time codes or card numbers. Take over the computer's screen (POST /computer/desktop) to do it. Starting while one records returns that one. Needs an owner or admin.
/api/v1/agents/{handle}/teachOther ways to call it
troopy teach startIdempotency-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/jsongoal*stringWhat you are about to show, like Refund an order in Stripe
At least 3 characters · At most 200 characters
Response
201 · 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