Skip to main content
POST
Change a reply automation's words, link, posts and stories, surfaces, whether its link is tracked, or follow-ups in place.

Authorizations

Authorization
string
header
required

A WorkOS-dashboard-issued internal API key on Authorization: Bearer.

Body

application/json
rule_id
string<uuid>
required

The rule id automation.arm answered with; keyword_rules.rule_id.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
keywords
string[]

The words that fire the reply, one to ten, each one word; a trigger carrying any of them as a whole word, in any case, is answered. No word may answer twice on one surface while both rules are on. When the creator names no word, ask which one should fire it before proposing, offering the word the reel's caption calls for when it names one; never invent a word.

Required array length: 1 - 10 elements
Required string length: 1 - 64
Pattern: ^[^\s<>]+$
message
string

The one line Dally sends as the creator, at most 800 Unicode code points; the link and the disclosure are added after it. When the creator gives no line, write one short line that offers what the reel promises and say it is yours; the board shows it and automation.edit changes it.

Required string length: 1 - 800

Where the link lands; https only.

content_ids
string<uuid>[]

The posts a comment listens on and the stories a story reply listens on, from content.content_id; empty means any of the creator's. The creator's latest post is their newest content row by published_at. Ignored on the dm surface.

Maximum array length: 50
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
surfaces
enum<string>[]

Which surfaces fire it, one to three: comment, story_reply, dm. Most creators name all three.

Required array length: 1 - 3 elements

comment: a comment on one of the automation's posts (reel, image or album), or on any of the creator's posts, answered in the commenter's DMs. story_reply: a reply to one of the automation's stories or highlights, or to any of the creator's stories, answered in that thread. dm: a DM carrying a keyword, answered in that thread.

Available options:
comment,
story_reply,
dm

true: the link is sent as dally.ai/r/, so taps, visits and sales are counted per person; false: the link is sent as typed and only sends and reads are counted

follow_ups
object

The whole set of follow-ups, replacing the ones the rule carries; an empty object drops them all.

Response

Success. request_id is present on every response.

rule
object
required

One reply automation: its surfaces, its posts and stories or any of them, its keywords, the one line Dally sends as the creator with the link and the disclosure, where it stands, and its counts.

show
object
required

How it is shown: dally_write renders this kind on this very answer, so the creator already sees the board; do not render it again. The board reads the creator's automations itself and takes no rows from you.

request_id
string
required

Server-minted id for this request. Present on every response, success and error — quote it when reporting a problem.

Minimum string length: 1