API reference / Troop
React to a troop chat message
Adds your reaction to a message in the troop chat, in the room or a thread. Reacting the same way twice keeps one. A message keeps at most 50 reactions.
/api/v1/troop/messages/{id}/reactionsOther ways to call it
troopy troop reacttroopy_react_in_troop_chatIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Path parameters
id*stringA 24-character id
Body
application/jsonemoji*enum<string>A reaction, by name
thumbs_upheartlaughpartyeyescheckprayfirethinking
Response
200 · application/jsondata*object15 properties
id*stringA 24-character id
threadId*string | nullThe thread it replies in, named by the thread's first message; null for a message in the room
from*enum<string>personagent
by*objectWho wrote it
3 properties
type*enum<string>personagentapi
id*stringname*stringagent*string | nullA teammate's message: its handle while it is in the troop; null once it was let go
avatar*object | nullA teammate's message: its face when it wrote it
6 properties
shape*enum<string>cloverflowertrianglesquareblobghostcircledropstardroidmechalienhexagoncatcloudpilland 2 more
color*stringface*enum<string>eyesmouth
shadingenum<string>How its body is lit; fabric when unset
fabricplasticcrispsmoothflat
robotobjectA TV-headed robot (robot-heads) in place of the bot. shape, color, face and shading stay for the bot
5 properties
shape*enum<string>rectanglesquarecirclehexagon
shell*stringThe colour of its shell
trim*stringThe colour of its ears and of the collar of its antenna
screen*stringThe colour of the lights on its screen
antenna*booleanobjectobjectAn object with two eyes in place of the bot. shape, color, face and shading stay for the bot
2 properties
shape*enum<string>circlesquaretrianglepilldrophexagonpentagoncloudbeancloverflowersparkleburstapplechatbulband 13 more
color*stringThe colour of the object
text*stringMarkdown when a teammate wrote it
to*array<string>A person's message: the handles of the teammates it called on, who each answer it in its thread
runId*string | nullA teammate's message: the run that wrote it
failed*booleanA teammate's message: its run failed, and the text says why
task*object | nullAn update: the task the teammate moved to in_review or done, as it was then
3 properties
key*stringtitle*stringstatus*enum<string>backlogtodoin_progressneeds_youin_reviewdonecanceled
approvalIds*array<string>A teammate's message: approvals its run asked for, waiting in GET /approvals
cites*array<object>A teammate's answer: what in the brain it relied on, at most 5, each one it was shown, as it is now (what was deleted since is left out)
5 properties
type*enum<string>docsource
id*stringA doc's slug, else the id
title*stringkind*stringA doc's or source's kind: a note, a web page, an interview, a research report...
wrong*object | nullA note someone said is wrong, and who: out of search until restored, or until they take it back
3 properties
by*objectWho wrote it
3 properties
type*enum<string>personagentapi
id*stringname*stringat*stringISO 8601 date and time
userId*stringA 24-character id
reactions*array<object>Reactions to it, each with who added it, in the order they first came
2 properties
emoji*enum<string>A reaction, by name
thumbs_upheartlaughpartyeyescheckprayfirethinking
by*array<object>3 properties
type*enum<string>personagentapi
id*stringname*stringat*stringISO 8601 date and time