Run Task | Athena | API Reference Docs

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.

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

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

Job ID for debugging

resultany

The task result

Errors

422

Unprocessable Entity Error

Run a task and wait for the result.

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

API Key authentication via header

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

This endpoint expects an object.

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

Arguments to pass to the task

Type: ‘script’ or ‘flow’

Whether execution succeeded

Error message if failed

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

Job ID for debugging

$	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": "string"
>	}'

1	{
2	"success": true,
3	"error": "string",
4	"error_type": "string",
5	"job_id": "string",
6	"result": null
7	}

$	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": "string"
>	}'

1	{
2	"success": true,
3	"error": "string",
4	"error_type": "string",
5	"job_id": "string",
6	"result": null
7	}