[DOCS] Python SDK: Missing `resume_session_at` option (TypeScript has `resumeSessionAt`)

Resolved 💬 2 comments Opened Jan 25, 2026 by coygeek Closed Feb 27, 2026

Documentation Type

missing documentation

Documentation Location

https://platform.claude.com/docs/en/agent-sdk/python

Section/Topic

Section: ClaudeAgentOptions — options table

Current Documentation

TypeScript SDK Options table (line 126):

| `resumeSessionAt` | `string` | `undefined` | Resume session at a specific message UUID |

Python SDK ClaudeAgentOptions options table does not include resume_session_at:

  • Has resume: str | None for resuming by session ID
  • Missing resume_session_at for resuming at a specific message UUID

What's Wrong or Missing?

The TypeScript SDK documents resumeSessionAt which allows resuming a session at a specific message UUID (useful for checkpointing workflows). The Python SDK only documents resume (session ID) but not the equivalent resume_session_at parameter.

This is either:

  1. A documentation gap if Python supports resume_session_at (it wraps the same CLI)
  2. A feature parity gap that should be noted

Affected Pages:
| Page | Line(s) |
|------|---------|
| platform.claude.com/docs/en/agent-sdk/python | ClaudeAgentOptions table |
| platform.claude.com/docs/en/agent-sdk/typescript | 126 |

Total scope: 2 pages affected

Suggested Improvement

If Python supports this option, add to the ClaudeAgentOptions table:

| `resume_session_at` | `str \| None` | `None` | Resume session at a specific message UUID |

And add to the dataclass definition:

resume_session_at: str | None = None

If Python doesn't support this, add a note to the TypeScript docs indicating it's TypeScript-only.

Impact

Medium - Makes feature difficult to understand

Additional Context

  • The File Checkpointing guide shows rewinding to specific message UUIDs
  • resumeSessionAt enables resuming at a checkpoint without replaying the full session
  • The CLI likely supports --resume-session-at which both SDKs should expose

View original on GitHub ↗

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