Run Task
GARun a task with the specified inputs and receive structured output.
This endpoint executes the task using its active revision(s) and returns the results. Key features:
- Automatic revision selection based on traffic weights
- Structured output matching the task’s output_format
- Execution metadata (tokens, timing, etc.)
- Support for file uploads when required
Required:
- Input parameters as defined in the task’s user_prompt
- Image file if task has image_required=true
Optional:
- Specific revision_id for testing or comparison
- Custom execution parameters
The response includes:
- Structured output matching the task’s output_format
- Execution metadata (tokens used, timing)
- Input data for audit purposes
- References to any processed images
Path parameters
org_id
The unique identifier of the organization.
project_id
The unique identifier of the project.
task_id
The specific Task to reference.
Headers
Authorization
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
revision_id
Optional Task Revision ID to use for execution. If not provided, an active revision will be selected based on traffic weights.
Response
Successful Response
task_id
The unique identifier of the Task associated with this run.
task_revision_id
The unique identifier of the Task Revision associated with this run.
response
The structured response from the Task execution.
run_data
Additional data about the Task execution, including submitted inputs and processed files.
id
The unique identifier of the Task Run.
created
The timestamp when the Task Run was created.
input_tokens
The number of tokens submit as input to the model.
output_tokens
The number of tokens generated and output by the model.
total_tokens
The total token usage for the TaskRun.
is_error
input_processor_timing
The execution time for the TaskRun in seconds.
llm_call_timing
The execution time for the TaskRun in seconds.
charged_credits
The total credits charged for the TaskRun.