Python SDK API reference signatures are stale

Open 💬 0 comments Opened Jun 1, 2026 by bar-d

What happened?

sdk/python/docs/api-reference.md appears to be stale relative to the current public Python SDK signatures.

Examples:

  • thread_start omits current kwargs such as service_name, service_tier, session_start_source, and thread_source.
  • thread_list omits current kwargs such as search_term, sort_direction, and use_state_db_only.
  • thread_resume and thread_fork are documented as defaulting approval_mode to ApprovalMode.auto_review, while the current generated APIs use approval_mode=None for existing-thread methods.

The source and signature tests include the current parameters, so this looks like documentation drift.

Expected behavior

The Python SDK API reference should match the generated public signatures, including newer kwargs and default values for existing-thread methods.

Additional context

I searched open issues and PRs for terms including Python SDK API reference, service_name, session_start_source, thread_source, and use_state_db_only, and did not find an existing open item that appears to cover this stale API reference.

View original on GitHub ↗