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

X-Workspace-ID

Header

string

Yes

Target workspace ID.

session_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

code

string

OK on success; HTTP status200.

msg

string

OK on success.

data.message

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.

Last updated on