Skip to main content
GET
Get Job Status
Polls the status of an asynchronous background job (e.g. AI preview via Bedrock). Returns the job record including status and result payload.

Authentication

Requires JWT Bearer token (Cognito). Jobs are scoped to the requesting user — you cannot access other users’ jobs.

Path Parameters

string
required
Job UUID returned from the job-creating endpoint (e.g. POST /api/admin/prompts/preview)Format: UUIDExample: 550e8400-e29b-41d4-a716-446655440000

Response

string
Job UUID
string
Job type enum valueValues: AI_PREVIEW, PARSE_DOCUMENT, GAP_DETECTION, RISK_ANALYSIS, REPORT_GENERATION
string
Current job statusValues: PENDING, PROCESSING, COMPLETED, FAILEDPoll every 3 seconds until status is COMPLETED or FAILED
object
Output from the worker Lambda when status is COMPLETED. Structure varies by job type.For AI_PREVIEW jobs:
  • output (string): The AI-generated preview text
string
Error message if status is FAILED
number
Number of processing attempts (max 3 retries)
string
ISO 8601 timestamp when the job was created
string
ISO 8601 timestamp when processing started
string
ISO 8601 timestamp when the job completed or failed
string
ISO 8601 timestamp of last status update

Example Request

Example Response (Completed)

Example Response (Processing)

Example Response (Failed)

Error Responses

error
Invalid UUID format
error
Missing or invalid Bearer token
error
Job not found or does not belong to the requesting user

Source Code

Implementation: packages/api/src/jobs/jobs.controller.ts:19