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_startomits current kwargs such asservice_name,service_tier,session_start_source, andthread_source.thread_listomits current kwargs such assearch_term,sort_direction, anduse_state_db_only.thread_resumeandthread_forkare documented as defaultingapproval_modetoApprovalMode.auto_review, while the current generated APIs useapproval_mode=Nonefor 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.