---
title: "Job worker (Cloud Tasks push, OIDC)"
method: POST
path: "/api/jobs/run"
tags: ["ops"]
---

# Job worker (Cloud Tasks push, OIDC)

`POST /api/jobs/run`

## Request

- Base URL: `https://api.wizbi.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wizbi.ai/api/jobs/run`
- Auth: none declared

## Request body

- JobEnvelope
  - `kind` string, required
  - `key` string, required
  - `payload` unknown
  - `orgId` string
  - `traceId` string
  - `enqueuedAt` string, required
  - `scheduled` object
    - `jobId` string, required
    - `slot` string, required

## Response `200`

Handled.

- JobRunResult
  - `status` 'done' | 'duplicate' | 'busy' | 'retry' | 'dead', required
  - `runId` string, required
  - `attempt` integer
  - `outcome` string
  - `error` string

## Other responses

- `401`: Not the task invoker.
- `500`: Failed; retry.
- `503`: Busy or disabled.

---

[API](https://skmtc.dev/wizbi/apis/wizbi-core-api.md) · [All operations](https://skmtc.dev/wizbi/apis/wizbi-core-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wizbi/apis/wizbi-core-api/revisions/5a47416c82ec?raw)