Skip to main content
GET
/
api
/
v1
/
agents
/
{agent_id}
/
tools
/
{tool_id}
/
executions
Get Tool Executions
curl --request GET \
  --url https://agent-studio.thena.ai/api/v1/agents/{agent_id}/tools/{tool_id}/executions \
  --header 'x-api-key: <api-key>'
[
  {
    "agent_tool_id": "123e4567-e89b-12d3-a456-426614174001",
    "duration_ms": 1500,
    "executed_at": "2023-01-01T00:00:00Z",
    "execution_id": "123e4567-e89b-12d3-a456-426614174002",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "input_parameters": {
      "query": "how to reset password"
    },
    "output_result": {
      "results": [
        "Found 3 articles"
      ]
    },
    "status": "completed"
  }
]

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
agent_id
string
required
​
tool_id
string<uuid>
required

Query Parameters

​
limit
integer
default:50

Maximum number of executions to return

​
offset
integer
default:0

Number of executions to skip

​
status
string

Filter by execution status

Response

Successful Response

​
id
string<uuid>
required

Unique identifier for the execution

​
agent_tool_id
string<uuid>
required

ID of the agent tool that was executed

​
status
string
required

Execution status: 'running', 'completed', 'failed'

​
executed_at
string<date-time>
required

When the tool was executed

​
execution_id
string<uuid> | null

ID of the flow execution this tool execution belongs to

​
input_parameters
Input Parameters · object

Input parameters passed to the tool

​
output_result
Output Result · object

Result returned by the tool

​
duration_ms
integer | null

Execution duration in milliseconds

​
error
string | null

Error message if execution failed