Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 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). |