sessions

Bulk delete persistent sessions

Permanently delete every non-internal persistent agent session, with its event history, that matches the optional app_name and search filters. Missing, null, or empty filters delete every non-internal session in the environment.

Required permission: retrieval.manage.

post/v1/projects/{project_id}/sessions/{environment_id}/bulk-delete

Request

  • Base URL: https://api.connic.co
  • URL: https://api.connic.co/v1/projects/{project_id}/sessions/{environment_id}/bulk-delete
  • Auth: HTTP bearer

Path parameters

project_idstring uuid required

ID of the project the API key belongs to.

environment_idstring uuid required

Environment ID from GET /environments.

Request body

app_namestring nullable

Non-empty agent application name to match exactly. An empty or null value applies no filter.

searchstring nullable

Case-insensitive session ID pattern. Text is matched anywhere; an unescaped percent (%) matches any sequence and an unescaped underscore (_) matches one character. An empty value applies no search filter.

Response

Successful Response

deleted_countinteger required

Number of sessions deleted.

Changes

No recorded changes to this operation across all 2 revisions of this API.