---
title: "Admin Run Job"
method: POST
path: "/v1/admin/run-job/{job_id}"
tags: ["admin"]
---

# Admin Run Job

`POST /v1/admin/run-job/{job_id}`

## Request

- Base URL: `https://api.bitpoort.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bitpoort.com/v1/admin/run-job/{job_id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Trigger ``job_id`` immediately.

- ``wait=true`` (default): direct-await the job's underlying coroutine,
  capture chainrag log records during the run, and return
  ``{status, job_id, elapsed_s, log_tail}``.
- ``wait=false``: APScheduler reschedule-to-now (queued behaviour),
  returns ``{status: "queued", job_id}``.

## Path parameters

- `job_id` string, required

## Request body

- RunJobBody
  - `wait` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/bitpoort/apis/bitpoort-api.md) · [All operations](https://skmtc.dev/bitpoort/apis/bitpoort-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitpoort/apis/bitpoort-api/revisions/1a51d8566777?raw)