Jobs
List jobs
List jobs
GET
https://example.thoughtindustries.com/incoming/v2/jobs/:idReturns the details of a background job by its unique identifier.
Example request
curl "https://example.thoughtindustries.com/incoming/v2/jobs/:id" \
-H 'Authorization: Bearer YOUR_API_KEY'Parameters
| Name | Type | Required | Location | Description |
|---|---|---|---|---|
id | uuid | Yes | path | The unique identifier of the background job to retrieve. |
Example response
{
"id": "00000000-0000-0000-0000-000000000000",
"description": "string",
"errorMessage": "string",
"status": "complete"
}Response fields
| Field | Type | Description |
|---|---|---|
id | uuid | Unique identifier of the background job. |
description | string | Human-readable summary of what the job does. |
errorMessage | string | Error details if the job failed; empty or absent when the job succeeded. |
status | BackgroundJobStatus | Current execution state of the job (e.g., complete). |