Docs

Reference

Rerun a failed job

Run a failed / expired job again as a new job (`replay_of` = the old one, which stays as it was). Not for jobs whose outcome is unknown (reconcile those), message sends (use messages.retry), logins, or campaign / nurture work (they retry themselves). A job that changes something on Telegram needs acknowledgeDuplicateRisk: true. The new job passes today's permissions, gate, quota and do-not-contact checks. Calling it again for the same job returns the same new job.

View MarkdownThis page is generated from the source code on every release.

Run a failed / expired job again as a new job (replay_of = the old one, which stays as it was). Not for jobs whose outcome is unknown (reconcile those), message sends (use messages.retry), logins, or campaign / nurture work (they retry themselves). A job that changes something on Telegram needs acknowledgeDuplicateRisk: true. The new job passes today's permissions, gate, quota and do-not-contact checks. Calling it again for the same job returns the same new job.

Overview

Name Value
Code jobs.redrive
Scope needed accounts.manage
Risk Dangerous
May need confirmation Yes
Runs as Queues work for a node
Needs Idempotency-Key Yes
Member roles allowed owner, manager
In the app Logs → failed row → Rerun

Input fields

Field Type Required Description
jobId uuid Yes
acknowledgeDuplicateRisk true/false No

Example request

curl -X POST https://tlg.builera.app/api/public/v2/ops/jobs.redrive \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <unique key per operation>" \
  -d '{"jobId":"00000000-0000-0000-0000-000000000000"}'

Output fields (data)

Field Type Required
ok true Yes
jobId text Yes
replayOf text Yes
deduped true/false Yes

Example answer

{
  "data": {
    "ok": true,
    "jobId": "00000000-0000-4000-8000-000000000000",
    "replayOf": "text",
    "deduped": true
  }
}

Using it over MCP

Not listed on any profile: call tools_describe then tools_run with code: "jobs.redrive". Tool name when listed: jobs_redrive.

Was this page helpful?

Last checked: 10/24/2026 · build 2.0