Skip to main content
Poll the status of an async build job started by startBuild, addDocs, or deleteDocs. Required fields: jobId
FieldTypeRequiredNotes
jobIdstring✅The job ID returned by the initiating action.
Example request 
curl -X POST "https://service.usemoss.dev/v1/manage" \
  -H "Content-Type: application/json" \
  -H "x-service-version: v1" \
  -H "x-project-key: moss_access_key_xxxxx" \
  -d '{
    "action": "getJobStatus",
    "projectId": "project_123",
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }'
Responses 
{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "progress": 100,
  "currentPhase": null,
  "error": null,
  "createdAt": "2025-01-09T21:14:07.000+00:00",
  "updatedAt": "2025-01-09T21:14:32.000+00:00",
  "completedAt": "2025-01-09T21:14:32.000+00:00"
}
FieldTypeNotes
jobIdstringThe job identifier.
statusstringOne of building, completed, or failed.
progressintegerPercentage complete (0–100).
currentPhasestring | nullCurrent build phase, or null when completed.
errorstring | nullError message if the job failed, otherwise null.
createdAtstringISO 8601 timestamp when the job was created.
updatedAtstringISO 8601 timestamp of the last status update.
completedAtstring | nullISO 8601 timestamp when the job completed, or null if still running.
Errors
  • 404 if the job ID is not found.