Sign in
Background Tasks

Append task run logs

Appends a batch of durable log/progress events. The unique (run, seq) key makes retries idempotent: duplicate seq values are counted as skipped.

post/v1/background-tasks/{slug}/runs/{runId}/events

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /v1/background-tasks/{slug}/runs/{runId}/events
  • Auth: HTTP bearer

Path parameters

slugstring required

Task slug.

Example:daily-summary

Background task slug, matching bg-tasks/<slug> locally.

runIdstring required

Run id.

Example:run-20260604-210000

Cloud-visible run id for a background task run.

Request body

Example request

{
  "events": [
    {
      "seq": 1,
      "type": "temporal.completed"
    }
  ]
}

Response

Append counts.

skippedinteger required

Number of duplicate seq events ignored.

storedinteger required

Number of events inserted.

Example response

{
  "skipped": 1,
  "stored": 2
}

Changes

No operation changes recorded.