Edit an X Play's audience or sequence
edit_x_playChange an X Play's name, audience rules, buying signal fields or attached sequence, exactly as the customer asked. Read the Play with list_x_plays first and pass its revision as expectedRevision; fields you leave out stay unchanged and the sender stays fixed. Signal fields (competitors, phrases and the rest) apply only to a Buying intent Play and replace its sources. A Play that enrolls automatically may route future people differently after an audience or sequence change. It never pauses, resumes or turns automatic enrollment on or off (set_x_play_status does that), connects accounts or sends anything. Returns the Play after the change.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"playId": "<playId>",
"expectedRevision": "<expectedRevision>"
},
"name": "edit_x_play"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | A new name for the Play. | |
| plan | No | Audience rules to change; each omitted rule stays as it is. | |
| playId | Yes | The X Play's ID, from list_x_plays. | |
| signal | No | Which buying signal the Play watches. competitor_followers: people following several competitor X accounts (competitors, minShared). competitor_post_engagers: people replying to, quoting or reposting the competitors' recent X posts (competitors, postsPerCompetitor). asks: people asking X and/or LinkedIn for a tool like the customer's (phrases, networks). complaints: people unhappy with a competitor on X and/or LinkedIn (phrases, competitors for X, competitorNames for LinkedIn). reddit: Reddit threads asking for what the customer sells, with a reply drafted for review (phrases, subreddits). | |
| phrases | No | asks, complaints, reddit: short search phrases in the words a buyer would write, e.g. "best bank for a startup" or "account frozen", never the company's own marketing terms. | |
| networks | No | asks, complaints: where to search; omitted means X only. | |
| minShared | No | competitor_followers: how many of the competitors a person must follow to count; omitted means 3, capped at the number of competitors. | |
| subreddits | No | reddit: subreddits to prefer, as r/name or name. Threads elsewhere on Reddit still count; omit to search all of Reddit. | |
| competitors | No | Competitor X accounts as @handle, handle or x.com profile link: at least two for competitor_followers, at least one for competitor_post_engagers, optional for complaints (anchors the X search). | |
| workspaceId | No | A teammate's workspace you may manage: an active workspace ID from list_team_workspaces. Omit for your own workspace. Supply on every call for a teammate. | |
| competitorNames | No | complaints on LinkedIn: competitor company names as written ("Mercury"), since LinkedIn posts name companies, not X handles. | |
| expectedRevision | Yes | The Play's current revision from list_x_plays; a stale revision is refused so a concurrent change is never overwritten. | |
| postsPerCompetitor | No | competitor_post_engagers: how many of each competitor's newest posts are read every day; omitted means 5. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| play | Yes | The Play after this call. | |
| changed | Yes | Whether this call changed anything. |