thread_unpin
Remove a thread’s pin. The thread goes back to its normal place in the forum, sorted by latest activity.
Request
Section titled “Request”{ "cmd": "thread_unpin", "thread_id": "0b7d1c2e-4f3a-4e8b-9a61-5c2d7e9f1a34"}| Field | Type | Required | Description |
|---|---|---|---|
thread_id |
string | Yes | ID of the thread to unpin. |
Response
Section titled “Response”{ "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.
Permissions
Section titled “Permissions”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.
Errors
Section titled “Errors”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. |
