Fetch a Task Run
Retrieve detailed information about a specific task run.
Task runs provide a complete record of task executions, including:
- Input parameters and configuration used
- Execution status and timing information
- Resource usage metrics (e.g., tokens consumed, credits charged)
- Structured output and processing metadata
- Error information if the run failed
- Fallback model information if the primary model failed
- Execution identity showing who caused the run and how it entered the platform
Response Fields:
Timing Metrics:
input_processor_timing: Time in seconds spent running input processors (e.g.,0.00015282)llm_call_timing: Time in seconds for the LLM API call (e.g.,1.346)
Resource Usage:
charged_credits: Credits charged for this execution as a string (e.g.,"1.00")input_tokens: Number of input tokens processedoutput_tokens: Number of output tokens generatedtotal_tokens: Combined token count
Retry & Fallback Information:
llm_retries: Number of retry attempts made before success or failureused_fallback_model: Boolean indicating if fallback model was usedprimary_failure_reason: Reason why the primary model failed (if applicable)fallback_llm_model_id: ID of the fallback model used (if applicable)
Input Data:
run_data.submitted: The original input parameters as submitted
Execution Identity:
actor_user_id: User whose authority caused the runactor_basis: Why that user was trusted as the actorexecution_surface: Platform entry point used to start the runexecution_source_id: Surface-specific ID for correlating the run
This endpoint is useful for:
- Monitoring task execution progress
- Debugging failed runs and understanding failover behavior
- Auditing task usage and performance
- Retrieving task results
- Analyzing reliability and fallback model usage
Errors:
- Returns 400 if the task run ID is not a valid UUID format
- Returns 422 if the request body fails validation
- Returns 404 if the task run is not found
- Returns 403 if the user lacks permission to access the task run
Authentication
API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.
API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.
Path parameters
Response
Additional data about the Task execution, including submitted inputs. submitted is absent on runs that failed before their input was recorded, so the object can be empty.
Surface-specific source identifier for correlating this run.