Get Job Status
Jobs
Get Job Status
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-446655440000Response
string
Job UUID
string
Job type enum valueValues:
AI_PREVIEW, PARSE_DOCUMENT, GAP_DETECTION, RISK_ANALYSIS, REPORT_GENERATIONstring
Current job statusValues:
PENDING, PROCESSING, COMPLETED, FAILEDPoll every 3 seconds until status is COMPLETED or FAILEDobject
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
FAILEDnumber
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