Stop a session

{
  "id": "sess_abc123",
  "status": "stopped",
  "current_step": 0,
  "step_count": 2,
  "results": [],
  "outcome": "stopped",
  "updated_at": "2026-07-13T12:02:00Z"
}

{
  "id": "sess_abc123",
  "status": "stopped",
  "current_step": 0,
  "step_count": 2,
  "results": [],
  "outcome": "stopped",
  "updated_at": "2026-07-13T12:02:00Z"
}

POST https://api.alentra.app/v1/sessions/{id}/stop · Auth: Bearer API key

Ends an active session without running its remaining steps. At a gate, it is the decision counterpart to continue; it may also be used to cancel a created or in-progress flow. The session moves to stopped and a session.stopped webhook fires after persistence.

Path parameters

string

required

The session id.

Behavior

Valid for any non-terminal, non-expired session. Calling it on an existing terminal state is idempotent and returns that state.
The deadline is checked first: a due session becomes expired, not stopped, and emits session.expired.
Owner-only: the API key’s business must own the session.
Already-completed steps remain verified and billed; remaining steps are skipped.

{
  "id": "sess_abc123",
  "status": "stopped",
  "current_step": 0,
  "step_count": 2,
  "results": [],
  "outcome": "stopped",
  "updated_at": "2026-07-13T12:02:00Z"
}

404 unknown session · 403 foreign session. See Errors.

Overview

Sessions

Audits

Discovery

Webhooks

Path parameters

Behavior

​Path parameters

​Behavior

Path parameters

Behavior