> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dari.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools & Skills

> Read observed tool and skill usage, inventories, and capability details.

<ParamField header="Authorization" type="string" required>`Bearer` plus a Management API key.</ParamField>
<ParamField query="from" type="string" required>RFC 3339 range start, inclusive.</ParamField>
<ParamField query="to" type="string" required>RFC 3339 range end, exclusive.</ParamField>
<ParamField query="router_id" type="string">Limit to one router.</ParamField>
<ParamField query="api_key_id" type="array">API key ID filter. Repeatable.</ParamField>
<ParamField query="user_id" type="array">Attributed user ID filter. Repeatable.</ParamField>
<ParamField query="model" type="array">Model ID filter. Repeatable.</ParamField>
<ParamField query="provider" type="string">Provider filter.</ParamField>
<ParamField query="status" type="string">`completed`, `provider_error`, `selector_error`, or `aborted`.</ParamField>
<ParamField query="key_source" type="string">`user`, `managed`, or `subscription`.</ParamField>
<ParamField query="source_scope" type="string">`openai_chat`, `openai_responses`, `anthropic_messages`, comma-separated, `all`, or `none`.</ParamField>
<ParamField query="mode" type="string" required>`tools` or `skills`.</ParamField>
<ParamField query="bucket_seconds" type="integer" required>Use `60`, `300`, `900`, `1800`, `86400`, `604800`, or `2592000`.</ParamField>
<ParamField query="series_id" type="array">Capability to include in the time series. Repeatable.</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.dari.dev/v1/organizations/current/routing/activity/tools-skills?mode=tools&from=2026-07-01T00:00:00Z&to=2026-07-08T00:00:00Z&bucket_seconds=86400&series_id=web_search" \
    -H "Authorization: Bearer $DARI_API_KEY"
  ```
</RequestExample>

The response contains `total_uses`, `total_items`, `items_truncated`, `items`, `series`, and `selected_series_ids`.

## Inventory

```http theme={null}
GET /v1/organizations/{org}/routing/activity/tools-skills/inventory
```

<ParamField query="search" type="string">Search capability names and IDs.</ParamField>
<ParamField query="sort_by" type="string" default="uses">`name`, `uses`, or `latest`.</ParamField>
<ParamField query="sort_direction" type="string" default="desc">`asc` or `desc`.</ParamField>
<ParamField query="limit" type="integer" default="50">Maximum capabilities.</ParamField>
<ParamField query="offset" type="integer" default="0">Capabilities to skip.</ParamField>

```bash theme={null}
dari activity tools list --from 2026-07-01T00:00:00Z --to 2026-07-08T00:00:00Z --search search
```

## Capability Detail

```http theme={null}
GET /v1/organizations/{org}/routing/activity/tools-skills/detail
```

<ParamField query="capability_id" type="string" required>Exact capability identity from inventory.</ParamField>

```bash theme={null}
dari activity tools get web_search --from 2026-07-01T00:00:00Z --to 2026-07-08T00:00:00Z
```

The detail response contains `item`, `series`, `identities`, `versions`, and `sources`.