Post a thread

When you finish this page, Rumora has queued one parent comment and at least one reply on the same video. You wrote every line. Rumora will not generate replies for you.

Before you start

You need all of this:

1. A team workspace with enough credits. Each line (parent and every reply) costs comment_credits from get_usage. Today that is 25 per line, so a parent plus one reply is 50.
2. An API key that starts with rmr_, copied from API keys.
3. A YouTube or TikTok video URL.
4. The parent text, and at least one reply text, already written.

Set these once:

export HOST=https://rumora.ai
export TOKEN='rmr_YOUR_TOKEN'

You can run the same commands in the playground.

1. Read live max length

curl -sS "$HOST/api/v1/usage" \
  -H "Authorization: Bearer $TOKEN"

Open limits for the platform of your URL. Every line you send must fit commentMaxLength for the parent and replyMaxLength for each reply. If credits_left is below comment_credits times the number of lines, buy credits first.

2. Send the parent and the replies

Replace VIDEO_URL, parent, and each reply content. replies must have at least one object. You may send at most 12 replies.

wait_hours is optional. It is how many hours Rumora waits after Post before sending that reply. Each reply allows 0 to 12. The sum across replies cannot exceed 48. Replies never send before the parent is live, even if wait_hours is 0.

Do not add a likes field. Like live lines later with like_comment.

curl -sS -X POST "$HOST/api/v1/threads" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "VIDEO_URL",
    "parent": "The pricing section is the part that matters.",
    "replies": [
      { "content": "The demo at 3:12 is the same claim.", "wait_hours": 2 }
    ],
    "idempotency_key": "thread-1"
  }'

You should see "type": "thread", "status": "queued", and line_count matching parent plus replies. Copy id. Credits for every line have already left the wallet.

If you see "code": "PARSE", read message. Common causes are an empty parent, empty replies, a reply without content, or text over the live max length.

3. Wait until the parent is live

Replace THREAD_ID with the id from step 2. Poll until identity is an object.

curl -sS "$HOST/api/v1/status/THREAD_ID" \
  -H "Authorization: Bearer $TOKEN"

Replies dispatch after this parent is live. You do not send the replies again.

4. Like a live line (optional)

If you want likes on the parent, use Comment then like from the like step, with this thread's identity. Set quantity to likeMin or higher from step 1.

If something fails

Match error.code in Errors. The field list is in post_thread.