> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Apr 17, 2026

> Latest updates and announcements

## Observability APIs: tool execution logs and usage metering

Two new v3.1 observability API surfaces are live.

## Tool execution logs

Search, filter, and paginate individual tool execution events. Use this for debugging failures, inspecting request/response payloads, and tracing user activity.

* `POST /api/v3.1/logs/tool_execution` — list with filters, time range, and cursor pagination.
* `GET /api/v3.1/logs/tool_execution/{id}` — full detail including request payload, response body, timings, and source metadata.

Authentication: project API key (`x-api-key`) or session cookie.

See the [tool execution logs guide](https://composio-preview.mintlify.site/reference/api-reference/logs).

## Usage metering

Aggregated counts of tool calls and sessions. Summary endpoints return totals; breakdown endpoints group results by tool, toolkit, user, session, or project.

* `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).
* `POST /api/v3.1/project/usage/summary` and `POST /api/v3.1/project/usage/{entity_type}` — project scope (`x-api-key` or cookie).

Entity types: `tool_calls`, `sessions`. Time ranges are epoch milliseconds; max range 366 days.

See the [usage metering guide](https://composio-preview.mintlify.site/reference/api-reference/organization).
