---
title: "get_job_status"
method: POST
path: "/get_job_status"
tags: ["job_status"]
---

# get_job_status

`POST /get_job_status`

## Request

- Base URL: `https://app.podmule.com/api/v1`
- URL: `https://app.podmule.com/api/v1/get_job_status`
- Auth: HTTP bearer

Look up the current state of a background job by its job_id (the uuid returned by an enqueue_* capability). Use this when the user asks 'is it done?' / 'is the show notes job ready?' / 'what's the status?' after an earlier enqueue. Returns lifecycle status (pending / running / completed / failed) plus optional progress notes the handler surfaces. If you don't have the job_id from an earlier turn in the same conversation, call get_recent_intent first to recover it.

## Request body

- unknown

## Response `200`

Capability output wrapped in `{ data }`.

- object
  - `data` unknown, required

## Other responses

- `400`: Invalid input — Zod validation failed.
- `401`: Missing, malformed, or audience-mismatched bearer token.
- `403`: Token is valid but lacks the required scope.
- `404`: Capability not registered, or referenced resource not found.
- `429`: Rate limit exceeded. Retry after the period in `Retry-After`.
- `500`: Internal error.

---

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