API reference / Needs you
List drafts
What teammates wrote for people to use (posts, emails, copy, briefs), newest first: ready ones unless status says otherwise.
/api/v1/draftsOther ways to call it
troopy drafts listtroopy_list_draftsQuery parameters
pageinteger1-based page number
Default 1 · At least 1
limitintegerItems per page, at most 100
Default 20 · At least 1 · At most 100
statusenum<string>readyuseddiscarded
Default "ready"
agentstringThe teammate's handle, like chief
At most 40 characters
Response
200 · application/jsondata*array<object>17 properties
id*stringA 24-character id
agent*stringThe teammate that wrote it
kind*enum<string>postemailarticlecopybriefother
title*stringbody*stringThe piece, in markdown
flags*array<string>What a person checks before use. For an article: the numbers that no page of its run shows
channel*string | nullWhere it goes, like linkedin or newsletter
status*enum<string>ready: waiting for a person. Nothing is sent or published by Troopy
readyuseddiscarded
runId*stringA 24-character id
threadId*string | nullThe conversation it came from
taskId*string | nullThe task it was written for
doc*string | nullThe slug of the doc that holds it, for a brief, copy or other piece. Its title and body are the doc's, as they are now
lead*object | nullA brief on a lead: the title and the body are its email, and POST /drafts/{id}/send sends it
8 properties
to*stringThe email of the lead
name*string | nullcompany*string | nullfit*integerHow well the lead fits who the business sells to, from 1 to 10
why*stringWhy that score
angle*string | nullThe reason to write to this lead
brief*stringWho they are and why they fit, in markdown
sent*booleanThe email went from Troopy
decidedBy*object | null3 properties
type*enum<string>personagentapi
id*stringname*stringdecidedAt*string | nullcreatedAt*stringISO 8601 date and time
updatedAt*stringISO 8601 date and time
pagination*object4 properties
page*integerlimit*integertotal*integerpages*integer