sessions

Delete persistent session

Permanently delete a persistent agent session and its event history. When both app_name and user_id are non-empty, only that exact session is deleted. Otherwise, every non-internal session with this session ID in the environment is deleted.

Required permission: retrieval.manage.

delete/v1/projects/{project_id}/sessions/{environment_id}/{session_id}

Request

  • Base URL: https://api.connic.co
  • URL: https://api.connic.co/v1/projects/{project_id}/sessions/{environment_id}/{session_id}
  • 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.

session_idstring required

Session ID from GET /sessions/{environment_id}.

Query parameters

app_namestring nullable

Agent application name. Used for exact targeting only when it and user_id are both non-empty.

user_idstring nullable

Agent user identity. Used for exact targeting only when it and app_name are both non-empty.

Response

Successful Response

okboolean required

Whether the operation succeeded.

Changes

No recorded changes to this operation across all 1 revision of this API.