Skip to main content
POST
Rewind a text test session
Requires membership in the requested workspace. Send a cursor_turn_id from the session and the latest expected_revision. A null cursor rewinds to the beginning. This changes the session’s active history; it does not undo actions already performed by external tools. A missing turn returns 404; a stale revision returns 409. The response contains the new revision and restored session state. Fetch the latest session before continuing the conversation.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Path Parameters

workflow_id
integer
required
run_id
integer
required

Body

application/json
cursor_turn_id
string | null
expected_revision
integer | null

Response

Successful Response

checkpoint
Checkpoint · object
required
created_at
string<date-time>
required
is_completed
boolean
required
mode
string
required
name
string
required
revision
integer
required
session_data
Session Data · object
required
state
string
required
workflow_id
integer
required
workflow_run_id
integer
required
annotations
Annotations · object | null
gathered_context
Gathered Context · object | null
initial_context
Initial Context · object | null
updated_at
string<date-time> | null