POST /api/link/unlink

Last updated 2 September 2026.

POST/api/link/unlink

End the link between your subject and its Trivela account, from your side. Idempotent. The link is recorded as ended, not deleted; a later reconnect is clean.

Request

Field	Type		Rules
`subject`	string	required	See the subject rules.

POST /api/link/unlink
Authorization: Bearer sk_yourservice_…
Content-Type: application/json

{ "subject": "u_8f31c2" }

Responses

200A live link was ended.

{ "service": "yourservice", "subject": "u_8f31c2", "unlinked": true, "unlinkedAt": "2026-09-02T09:41:03.000Z" }

200There was nothing live to end. A success, not an error; never linked and already unlinked are not distinguished.

{ "service": "yourservice", "subject": "u_8f31c2", "unlinked": false, "unlinkedAt": null }

400Malformed subject. Do not treat as a disconnect.

{ "error": "subject …" }                                          // any subject rule

401Bad or missing key.

{ "error": "Unknown or missing service key." }

Notes

Players can also disconnect from their Trivela account page. There is no callback for that; your next /api/link/status returns { "linked": false }.