Get LRT job status

Learn more about get LRT job status.

Use the Get LRT job status to get the status of an LRT job. This lets you poll a job's status without retrieving its full result.

HTTP method and endpoint

Use the following HTTP method and endpoint path to get LRT job status.

GET {TenantURL}/ai/agentflow/api/v202605/{tenant_id}/lrt/jobs/{job_id}/status

The following table describes the endpoint path parameters.


Parameter	Type	Required	Description
`TenantURL`	String	Yes	The base URL for your tenant.
`job_id`	String	Yes	The unique identifier of the LRT job.
`tenant_id`	String	Yes	The tenant identifier.

Request headers

The following request headers must be included.


Header	Value	Required
`Authorization`	`<access_token>`	Yes

Request body

This operation does not require a request body.

Example request

Use the following example to see how a complete request is structured, with headers.

GET {TenantURL}/ai/agentflow/api/v202605/tenant-xyz/lrt/jobs/example-id/status
Authorization: <access_token>

Response body

The following table describes the fields returned in the response body.


Parameter	Type	Description
`job_id`	String	The unique identifier of the LRT job.
`tenant_id`	String	The unique identifier of the tenant.
`status`	String	The status of the job.
`conversation_id`	String	The unique identifier of the conversation that the job created.
`agent_id`	String	The unique identifier of the agent that the job or schedule runs.
`created_at`	String	The date and time when the job or schedule was created.
`updated_at`	String	The date and time when the record was last updated.
`last_error`	String	The most recent error for the job, if any.

Example response

The following example shows a response with successful response.

{
  "job_id": "0b4720e4-0b1c-41f7-9b53-0ebc907f45f8",
  "tenant_id": "tenant-xyz",
  "status": "running",
  "conversation_id": "<string>",
  "agent_id": "MRA",
  "created_at": "<string>",
  "updated_at": "<string>",
  "last_error": "<string>"
}

Error codes and recommended actions

The following table lists the possible error responses returned by this API.


HTTP status	Description	Recommended action
`422 Unprocessable Entity`	Validation Error	Review the request parameters or body, correct the invalid values, and resend the request.

Unify and manage your data