Run Task | Athena | API Reference Docs

Run a task and wait for the result.

Executes a serverless function script or flow synchronously. Server handles polling internally.

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

Authentication

X-API-KEYstring

API Key authentication via header

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’

Response

Successful Response

successboolean

Whether execution succeeded

errorstring or nullOptional

Error message if failed

error_typestring or nullOptional

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

job_idstring or nullOptional

Job ID for debugging

resultanyOptional

The task result

Errors

422

Unprocessable Entity Error

$	curl -X POST https://api.athenaintel.com/api/v0/tools/tasks/run \
>	-H "X-API-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"task_id": "f/public/databricks_describe_table"
>	}'

1	{
2	"success": true,
3	"error": "null",
4	"error_type": "null",
5	"job_id": "job_20240612_153045",
6	"result": "Table 'sales_data' has 1,234 rows and 12 columns."
7	}