Skip to content

Docs: clarify completion and cleanup for singular delete_user on the legacy route #252

Open

Description

@Zia5278

Could the legacy Python SDK document the completion and cleanup guarantees for singular delete_user? This affects what an existing integration can safely record when an account deletion returns successfully or the response is lost.

The Python interface describes this method as synchronous and its implementation calls DELETE /users/{user_id}. The plural delete_users calls a separate endpoint and has a documented task workflow. In the JavaScript SDK v9.5.1, the response type for the same singular route includes an optional task_id. That type alone does not establish when the server returns one.

For this specific Python invocation:

client.delete_user(
    "example-user",
    hard_delete=True,
    mark_messages_deleted=True,
    delete_conversation_channels=True,
)
  1. What has finished on a successful response without a task ID? If a task ID is returned, which work does it cover and should the caller poll it?
  2. Does mark_messages_deleted=True preserve or erase message content and attachments? Which conversation channels are affected? Please identify any cleanup of uploaded files or Video data that requires a separate operation.
  3. After a transport timeout, is there an authoritative read-only confirmation for this exact request, or a documented safe retry? In particular, what does a matching user.deleted event establish about completion of the requested cleanup?

A short note in the method documentation pointing existing callers to the applicable server contract or supported replacement would help. This request is based on the published interfaces. We have not performed a deletion to test these questions.

Python interface · Python implementation · JavaScript singular response type · User deletion guide

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions