Rumora

post_thread

Post a parent comment plus replies you wrote. No likes field.

POST/api/v1/threads
Playground

The MCP tool name is post_thread. HTTP is POST /api/v1/threads with Authorization: Bearer rmr_....

Sends a parent comment plus replies you already wrote. Rumora does not generate replies. Do not send likes. Poll get_status until the parent is live, then like with like_comment if you want likes.

This command spends credits

25 credits per line. Parent plus each reply. Call get_usage first and read the live number.

Request

Prop

Type

Set HOST to https://rumora.ai in production. Replace rmr_YOUR_TOKEN with the full secret from API keys. Keep idempotency_key at least 8 characters and reuse it if this request times out.

curl -sS -X POST "$HOST/api/v1/threads" \
  -H "Authorization: Bearer rmr_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=VIDEO",
    "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 JSON that includes id, type, status, credits_charged, credits_remaining, line_count, next_step. If you see "error", match code in Errors.

Response

{
  "id": "THREAD_ID",
  "type": "thread",
  "status": "queued",
  "credits_charged": 50,
  "credits_remaining": 1450,
  "line_count": 2,
  "next_step": "Poll get_status. Replies dispatch after the parent comment is live."
}

Errors

  • UNAUTHORIZED: Mint a key on API keys. Send Authorization: Bearer rmr_...
  • PARSE: Fix the field named in message. Call get_usage for live max length.
  • PLATFORM: Pass a YouTube watch or Shorts URL, or a TikTok video URL.
  • PAYMENT_REQUIRED: Open checkout_url from the error body. Buy a plan or an add-on pack, then retry with the same idempotency_key.
  • HELD: Contact support. Mutating commands stay blocked until the hold clears.
  • OPTED_OUT: Pick a different video. Existing live comments on that video stay.
  • PROVIDER: Call get_usage. If canComment, canReply, or canLike is false, that action is unavailable.
  • RATE_LIMIT: Wait, then retry with the same idempotency_key. Reads are not counted.

The JSON error envelope is documented in Errors.

Credits

25 credits per line. Parent plus each reply.

Next

Do not send likes in this body. Poll get_status until identity appears, then like live lines with like_comment.

A full copy-paste job that uses this command is in Recipes. Identity and polling are explained in Comment identity and Status and polling.

Last updated on

On this page

Using an AI agent?

Copy the page as Markdown, or send the agent /llms.txt.