New words for a post
new_wordsNew words and hashtags for one draft post, written by Audora for the post's own idea, in the campaign's language or the one you name. Its picture or video stays as it is; nothing new is made. Replaces the post's words. feedback is the artist's note on what should change. Costs 1 credit (the dry run says the price); the real call needs the artist's spend permission. dry_run first, tell the artist the price, then confirm_cost_credits. To write the words yourself, use update_post (free).
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": {
"post_id": "<post_id>"
},
"name": "new_words"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| artist | No | Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection. | |
| dry_run | No | True to see the price, changing nothing. Do this first and tell the artist. | |
| post_id | Yes | The post's id (post_id from get_campaign or promo_this_week). | |
| feedback | No | Optional, ≤ 2000 characters: what should change in the words, in the artist's own words. | |
| post_language | No | Optional: write it in this language, which the post then keeps as its own. The campaign's own language makes the post follow the campaign again. | |
| idempotency_key | No | Send the same key if you retry, and the change happens once. | |
| confirm_cost_credits | No | The price a dry run quoted and you told the artist. Required for the real call. |