Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

next
mdx 29 lines 1.4 KB
Raw
1 ---
2 title: "Observability APIs: tool execution logs and usage metering"
3 description: "Query individual tool execution logs and aggregated usage counts for your org or project via v3.1 REST endpoints."
4 date: "2026-04-17"
5 ---
6
7 Two new v3.1 observability API surfaces are live.
8
9 ## Tool execution logs
10
11 Search, filter, and paginate individual tool execution events. Use this for debugging failures, inspecting request/response payloads, and tracing user activity.
12
13 - `POST /api/v3.1/logs/tool_execution` — list with filters, time range, and cursor pagination.
14 - `GET /api/v3.1/logs/tool_execution/{id}` — full detail including request payload, response body, timings, and source metadata.
15
16 Authentication: project API key (`x-api-key`) or session cookie.
17
18 See the [tool execution logs guide](/reference/api-reference/logs).
19
20 ## Usage metering
21
22 Aggregated counts of tool calls and sessions. Summary endpoints return totals; breakdown endpoints group results by tool, toolkit, user, session, or project.
23
24 - `POST /api/v3.1/org/usage/summary` and `POST /api/v3.1/org/usage/{entity_type}` — org scope (`x-org-api-key` or org JWT).
25 - `POST /api/v3.1/project/usage/summary` and `POST /api/v3.1/project/usage/{entity_type}` — project scope (`x-api-key` or cookie).
26
27 Entity types: `tool_calls`, `sessions`. Time ranges are epoch milliseconds; max range 366 days.
28
29 See the [usage metering guide](/reference/api-reference/organization).