Skip to content

Get Run Status

Request

Retrieve the current status of a run by its ID.

Overview

This endpoint allows you to quickly check the status of a run without retrieving all the detailed information.

Path Parameters

  • run_id: The unique identifier of the batch run (UUID format)

Response

Returns the run ID and its current status.

Examples

Example Response

{
  "run_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "completed"
}

Possible Status Values

  • queued: The run is queued
  • completed: The run has completed successfully
  • failed: The run has failed

HTTP Status Codes

CodeMeaning
200 OKRun status retrieved successfully
400 Bad RequestInvalid run ID format
404 Not FoundRun not found
500 Internal Server ErrorServer error occurred while retrieving status
Security
BearerAuth
Path
run_idstring(Run Id)required
curl -i -X GET \
  'https://api-gateway.agenthq.withlantern.com/v1/agents/runs/{run_id}/status' \
  -H 'Authorization: Bearer <YOUR_ApiToken_HERE>'

Responses

Run status retrieved successfully

Bodyapplication/json
run_idstring, (uuid)(Run Id)required

Unique identifier for the run

Example:"123e4567-e89b-12d3-a456-426614174000"
statusstring(RunStatus)required

Current status of the run

Enum:"queued""queued""failed""completed""failed"
Example:"queued"
Response
{
  "run_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "completed"
}