Sessions

Delete a visitor session

DELETE/api/websites/{websiteId}/sessions/{sessionId}

Deletes the specified session and its associated analytics data. Available on installations using only a relational database.

Try it

Name	Type	Description
Authorizationrequired	string	Token returned by POST /api/auth/login, or an API key (`umami_…`) created under Settings → API keys (self-hosted only). `Bearer <token>`.

Name	Type	Description
websiteIdrequired	string	ID of the website.
sessionIdrequired	string	ID of the visitor session.

200The operation completed successfully.

Name	Type	Description
okrequired	boolean	Whether the operation succeeded.

200 example

{
  "ok": true
}

400Bad request.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

400 example

{
  "error": {
    "code": "bad-request",
    "message": "Bad request.",
    "status": 400
  }
}

401Unauthorized.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

401 example

{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized.",
    "status": 401
  }
}

404Not found.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

404 example

{
  "error": {
    "code": "not-found",
    "message": "Not found.",
    "status": 404
  }
}

cURL

curl -X DELETE 'https://api.example.com/api/websites/{websiteId}/sessions/{sessionId}' \
  -H 'Authorization: Bearer <token>'