API ReferenceToolsTasks

Run Task

Beta
Run a [task](https://resources.athenaintel.com/docs/task-studio/home) and wait for the result. Executes a Windmill script or flow synchronously. Server handles polling internally.

Authentication

X-API-KEYstring
API Key authentication via header
OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
task_idstringRequired

The unique identifier (path) of the task. Example: ‘f/public/databricks_describe_table’

argumentsmap from strings to anyOptional
Arguments to pass to the task
task_typeenumOptionalDefaults to script

Type: ‘script’ or ‘flow’

Allowed values:

Response

Successful Response
successboolean
Whether execution succeeded
errorstring or null
Error message if failed
error_typestring or null

Error type: ‘timeout’, ‘execution_error’, ‘not_found’, ‘validation_error’

job_idstring or null
Windmill job ID for debugging
resultany or null
The task result

Errors