Unpin a UI protocol conversation¶
Maintain conversation records owned by the current user.
DELETE https://api.moi.matrixorigin.cn/v5/sessions/{session_id}/pin
Before you call this API¶
BASE_URL uses the product API prefix https://api.moi.matrixorigin.cn/v5. For a dedicated deployment, use its corresponding product API address.
Configure identity, workspace, and numeric record IDs in the same environment. This endpoint uses regular product authentication and rejects additional task-runtime authorization headers.
Request¶
curl --request DELETE \
"$BASE_URL/sessions/$SESSION_ID/pin" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID"
Parameter |
Location |
Type |
Required |
Description |
|---|---|---|---|---|
|
Header |
string |
Yes |
Target workspace ID. |
|
Path |
integer |
Yes |
Positive integer record ID owned by the current user. |
Returns HTTP 200 with an operation-result object, not204. Sets or removes the system/pinned relation. Confirm through pinned reads rather than empty tags in the conversation object.
Successful response¶
{
"code": "OK",
"msg": "OK",
"data": {
"message": "unpinned"
}
}
Field |
Type |
Description |
|---|---|---|
|
string |
OK on success; HTTP status200. |
|
string |
OK on success. |
|
string |
Operation result: pinned, unpinned, or deleted. |
Error response¶
Error formats and result confirmation distinguishes detail not-found from general service errors on other endpoints.