Skip to content

thread_unpin

Remove a thread’s pin. The thread goes back to its normal place in the forum, sorted by latest activity.

{
"cmd": "thread_unpin",
"thread_id": "0b7d1c2e-4f3a-4e8b-9a61-5c2d7e9f1a34"
}
Field Type Required Description
thread_id string Yes ID of the thread to unpin.
{
"cmd": "thread_unpin",
"thread_id": "0b7d1c2e-4f3a-4e8b-9a61-5c2d7e9f1a34",
"channel": "projects",
"pinned": false
}

channel is the parent forum. The thread now has pinned: false and no pinned_at. Unpinning a thread that isn’t pinned also succeeds.

The same frame is broadcast to every other connection whose user can view the forum, without listener.

You must be an administrator (the owner, a user with the admin role, or a role with administrator) or have a role with manage_threads.

The command is blocked while you are timed out.

val When
Thread not found No thread has this ID.
You do not have permission to unpin threads You are not an administrator and lack manage_threads.
Unable to save thread The server could not write the change to storage.
Validation message thread_id is missing or empty, for example thread_id: Required.