[DOCS] Documentation Inconsistency: `SubagentStop` schema missing fields on code.claude.com vs platform.claude.com

Resolved 💬 4 comments Opened Jan 19, 2026 by coygeek Closed Feb 27, 2026

Documentation Type

Unclear/confusing documentation

Documentation Location

https://code.claude.com/docs/en/hooks#stop-and-subagentstop-input

Section/Topic

The "Stop and SubagentStop Input" section code example.

Current Documentation

The JSON example provided at code.claude.com for SubagentStop is identical to the one for Stop:

{
  "session_id": "abc123",
  "transcript_path": "~/.claude/projects/.../00893aaf-19fa-41d2-8238-13269b9b3ca0.jsonl",
  "permission_mode": "default",
  "hook_event_name": "Stop",
  "stop_hook_active": true
}

What's Wrong or Missing?

The CLI documentation (code.claude.com) has not been synced with the SDK documentation (platform.claude.com). While the latter correctly lists agent_id and agent_transcript_path in its tables, the CLI site's reference example omits them entirely. This is confusing for CLI users who rely on the code examples to build their hook scripts.

Suggested Improvement

Separate the Stop and SubagentStop examples on code.claude.com. The SubagentStop example should explicitly show the agent_id and agent_transcript_path fields introduced in v2.0.42.

Impact

High - Prevents users from using a feature

Additional Context

Syncing these examples will ensure that developers working across the CLI and the SDK have a unified understanding of the data available to their hooks.

View original on GitHub ↗

This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗