startBuild, addDocs, deleteDocs,
createWebSource, or resyncWebSource.
Required fields: jobId
| Field | Type | Required | Notes |
|---|---|---|---|
jobId | string | ✅ | The job ID returned by the initiating action. |
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"
}'
{
"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"
}
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "building",
"progress": 45,
"currentPhase": "indexing",
"error": null,
"createdAt": "2025-01-09T21:14:07.000+00:00",
"updatedAt": "2025-01-09T21:14:15.000+00:00",
"completedAt": null
}
| Field | Type | Notes |
|---|---|---|
jobId | string | The job identifier. |
status | string | One of building, completed, or failed. Web crawl jobs may briefly report queued before building. |
progress | integer | Percentage complete (0-100). |
currentPhase | string | null | Current build phase, or null when completed. Web crawl jobs move through crawling, parsing_documents (when linked files are found), and building_index. |
error | string | null | Error message if the job failed, otherwise null. |
createdAt | string | ISO 8601 timestamp when the job was created. |
updatedAt | string | ISO 8601 timestamp of the last status update. |
completedAt | string | null | ISO 8601 timestamp when the job completed, or null if still running. |
404if the job ID is not found.