Skip to main content
Version: Current

Get Job Status

Overview​

Retrieve the execution status of a job.

Endpoint​

GET /api/job/status

Use the service origin described in Getting started. The path above already includes /api.

Authentication​

Send the access token obtained from Get Access Token in the Authorization header. Access is limited by the authenticated account’s permissions.

Request headers​

Accept: text/plain
Authorization: Bearer ACCESS_TOKEN

Query parameters​

ParameterTypeRequirementDescription
idintegerRequiredJob ID returned by Start Job.

Request example​

The following example uses cURL in a POSIX shell. Replace example credentials and IDs before running it. Replace the AI Command Center origin with your deployment address.

curl --request GET \
--url 'https://command-center.example.com/api/job/status?id=60' \
--header 'Accept: text/plain' \
--header 'Authorization: Bearer ACCESS_TOKEN'

Response​

Successful status: 200 OK.

Content type: text/plain; charset=utf-8.

Completed

Completed is the documented example. Confirm the complete set of statuses before implementing terminal-state detection.

Errors​

Endpoint-specific error statuses and response bodies are not yet documented. See Usage and troubleshooting for general handling guidance.