# record_model_usage_event

> **Function** in `deepagents_code`

📖 [View in docs](https://reference.langchain.com/python/deepagents-code/_session_stats/record_model_usage_event)

Record a validated provisional usage event from a nested model call.

## Signature

```python
record_model_usage_event(
    stats: SessionStats,
    data: object,
    *,
    active_thread_id: str = '',
    fallback_model: str = '',
    fallback_provider: str = '',
    recorded_requests: dict[UsageLedgerKey, RecordedRequest] | None = None,
    attempt_scope: Hashable | None = None,
) -> RecordedUsage | None
```

## Returns

`RecordedUsage | None`

The recorded usage delta, or `None` when the event is invalid or duplicate.

---

[View source on GitHub](https://github.com/langchain-ai/deepagents/blob/4bfa52000ef65ac623d8ada0cb67f67cbdd663ea/libs/code/deepagents_code/_session_stats.py#L1240)