Delete Multiple Sessions

Delete multiple sessions by their IDs in a single operation. This action cannot be undone and will permanently remove all specified sessions and their runs.

DELETE /sessions

Delete Multiple Sessions

cURL

curl --request DELETE \
  --url https://api.example.com/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_ids": [
    "<string>"
  ],
  "session_types": [
    "agent"
  ]
}
'

400

{
  "detail": "Bad request",
  "error_code": "BAD_REQUEST"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

user_id · string | null

User ID to scope deletion to

db_id · string | null

Database ID to use for deletion

table · string | null

Table to use for deletion

Body

application/json

session_ids · string[] · required

List of session IDs to delete

Minimum array length: 1

session_types · enum<string>[] · required

Types of sessions to delete

Minimum array length: 1

Available options: agent, team, workflow

Response

204

Sessions deleted successfully