thread_delete

Delete a thread for good. This removes the thread, every message in it, and any polls posted in it. It can’t be undone; to hide a thread but keep its history, archive it with thread_update instead.

Request

{
  "cmd": "thread_delete",
  "thread_id": "0b7d1c2e-4f3a-4e8b-9a61-5c2d7e9f1a34"
}

Field	Type	Required	Description
`thread_id`	string	Yes	ID of the thread to delete.

Response

{
  "cmd": "thread_delete",
  "thread_id": "0b7d1c2e-4f3a-4e8b-9a61-5c2d7e9f1a34",
  "channel": "projects"
}

channel is the forum the thread was in. The same frame is broadcast to every other connection whose user can view that forum, without listener. Remove the thread from your lists when you receive it.

Permissions

You must be one of:

the thread’s creator,
an administrator (the owner, a user with the admin role, or a role with administrator), or
a user whose role has manage_threads.

The command is blocked while you are timed out.

Errors

`val`	When
`Thread not found`	No thread has this ID.
`You do not have permission to modify this thread`	You didn’t create the thread and can’t manage threads.
Validation message	`thread_id` is missing or empty, for example `thread_id: Required`.

See also