Delete end user session for alias
DELETE/v2/agent_aliases/:alias_key/end_user_sessions/:session_key
Permanently deletes a session the caller owns, addressed by the alias it was created through. Returns 403 if the session belongs to a different principal. This action cannot be undone.
An administrator calling this operation is bound to the sessions it owns like every other caller; the operator endpoints are the administrative view of an alias's sessions.
Anonymous widget visitors authenticate by presenting X-Visitor-Id instead of an Authorization credential; the platform mints an identity holding agent_end_user on the addressed alias, which satisfies this operation's role requirement.
Request
Responses
- 204
- 401
- 403
- 404
The session is deleted.
The request carries no valid credential — no Authorization, and for anonymous callers a missing, malformed, or badly signed X-Visitor-Id.
The session does not belong to the caller, or permissions do not allow deletion. For an anonymous visitor, also returned when the session's connector no longer admits anonymous visitors. Also returned when the request Origin is not in the connector's allowed_origins. Origin checks apply only while the connector remains enabled; disabling or deleting it preserves the other admission and ownership checks.
Alias or session not found.