List app usages

See which agents use an integration app and its most recent executions.

GEThttps://api.tried.com.au/list-app-usages/{id}

Returns the agents whose latest LLM or conversation flow has a tool that names this app, plus execution counts and the most recent executions. Every run is logged here, whether it came from a call, a chat, a workflow or Execute app action.

Request#

Path parameter	Type	Required	Description
`id`	string	Yes	The `app_id`.

Query parameter	Type	Required	Description
`limit`	integer	No	Most executions to return, newest first. 1 to 200, default 50.

Example request#

curl "https://api.tried.com.au/list-app-usages/app_6f1c2a9e4b7d3058a1e2c4f9?limit=20" \
  -H "Authorization: Bearer $TRIED_API_KEY"

const res = await fetch(
  "https://api.tried.com.au/list-app-usages/app_6f1c2a9e4b7d3058a1e2c4f9?limit=20",
  { headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` } },
);
const usages = await res.json();

import os, requests

res = requests.get(
    "https://api.tried.com.au/list-app-usages/app_6f1c2a9e4b7d3058a1e2c4f9",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
    params={"limit": 20},
)
usages = res.json()

Response#

200 OK

{
  "app_id": "app_6f1c2a9e4b7d3058a1e2c4f9",
  "agents": [
    { "agent_id": "agent_4e2b9c7a1d5f3068b9c2e7a4", "agent_name": "Clinic receptionist" }
  ],
  "total_executions": 42,
  "failed_executions": 3,
  "executions": [
    {
      "usage_id": "app_usage_8c1f4e7a2b9d5036c4a8e1f7",
      "action": "cal_com.book_appointment",
      "call_id": "call_7a3e9c1b5d2f4086a1c7e3b9",
      "success": true,
      "mock": false,
      "duration_ms": 612,
      "error": null,
      "request": { "start": "2026-10-21T09:00:00+11:00", "name": "Sam Nguyen", "email": "sam@example.com" },
      "response": { "booking": { "uid": "abc123", "start": "2026-10-21T09:00:00+11:00", "status": "accepted" } },
      "created_timestamp": 1792395000000
    }
  ]
}

Field	Type	Description
`agents`	object[]	Agents (latest version) whose response engine's latest LLM or flow references this `app_id`.
`total_executions`	integer	All logged executions of this app.
`failed_executions`	integer	Executions with `success: false`.
`executions[].call_id`	string or null	The call or chat ID that ran the action. `null` for runs from Execute app action.
`executions[].request`	object	Arguments the action ran with, after `static_arguments` were merged in.
`executions[].response`	object	Full vendor (or mock) output. `{}` when the action failed.
`executions[].error`	string or null	Error message when `success` is `false`.

Errors#

Status	When
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request. This route needs the `admin` scope.
`404`	`App <id> not found` in this workspace.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.

Retell compatibility#

Same path and method as Retell, but a different shape. Retell returns a paginated items list of agent and knowledge base references. Tried returns agents plus counts and an executions log, and takes only limit.