POST
/api/v1/org/{org}/ws/{workspace}/sessions/{session_id}/rewind
Hard-truncate a session transcript at a target user message.
Deletes the target row and every later row, returning the deleted
target’s content so the caller can restore it to the composer for
editing/resend. Frozen, non-user-origin, and other-user sessions
are rejected per SES-RWD-* / SES-FRZ-012.
Session Id string format: uuid
Select media type application/json RewindTranscriptRequest Hard-truncate the transcript at a target user-message seq.
object From Seq Target user-message seq. The message at this seq and every later message are deleted. Must point to a non-compacted message with role=‘user’.
integer
Select media type application/json RewindTranscriptResponse Result of a rewind. Echoes the deleted target’s content so the
caller can restore it to the composer in a single round-trip.
object restored_content required
Select media type application/json APIErrorPayload Canonical API error envelope returned by the API.
object Code integer
Allowed values: 400 401 403 404 409 422 426 429 500 502 504
Detail Human-readable error message
string
errors
Any of:
Array<object>
ValidationErrorItem object Loc Where the validation error occurred
Array
Msg Human-readable validation message
string
Type Machine-readable validation error type
string
Type Stable machine-readable error type
string
Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error
Select media type application/json APIErrorPayload Canonical API error envelope returned by the API.
object Code integer
Allowed values: 400 401 403 404 409 422 426 429 500 502 504
Detail Human-readable error message
string
errors
Any of:
Array<object>
ValidationErrorItem object Loc Where the validation error occurred
Array
Msg Human-readable validation message
string
Type Machine-readable validation error type
string
Type Stable machine-readable error type
string
Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error
Select media type application/json APIErrorPayload Canonical API error envelope returned by the API.
object Code integer
Allowed values: 400 401 403 404 409 422 426 429 500 502 504
Detail Human-readable error message
string
errors
Any of:
Array<object>
ValidationErrorItem object Loc Where the validation error occurred
Array
Msg Human-readable validation message
string
Type Machine-readable validation error type
string
Type Stable machine-readable error type
string
Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error
Select media type application/json APIErrorPayload Canonical API error envelope returned by the API.
object Code integer
Allowed values: 400 401 403 404 409 422 426 429 500 502 504
Detail Human-readable error message
string
errors
Any of:
Array<object>
ValidationErrorItem object Loc Where the validation error occurred
Array
Msg Human-readable validation message
string
Type Machine-readable validation error type
string
Type Stable machine-readable error type
string
Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error
Select media type application/json APIErrorPayload Canonical API error envelope returned by the API.
object Code integer
Allowed values: 400 401 403 404 409 422 426 429 500 502 504
Detail Human-readable error message
string
errors
Any of:
Array<object>
ValidationErrorItem object Loc Where the validation error occurred
Array
Msg Human-readable validation message
string
Type Machine-readable validation error type
string
Type Stable machine-readable error type
string
Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error
Select media type application/json APIErrorPayload Canonical API error envelope returned by the API.
object Code integer
Allowed values: 400 401 403 404 409 422 426 429 500 502 504
Detail Human-readable error message
string
errors
Any of:
Array<object>
ValidationErrorItem object Loc Where the validation error occurred
Array
Msg Human-readable validation message
string
Type Machine-readable validation error type
string
Type Stable machine-readable error type
string
Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error
Select media type application/json APIErrorPayload Canonical API error envelope returned by the API.
object Code integer
Allowed values: 400 401 403 404 409 422 426 429 500 502 504
Detail Human-readable error message
string
errors
Any of:
Array<object>
ValidationErrorItem object Loc Where the validation error occurred
Array
Msg Human-readable validation message
string
Type Machine-readable validation error type
string
Type Stable machine-readable error type
string
Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error
Select media type application/json APIErrorPayload Canonical API error envelope returned by the API.
object Code integer
Allowed values: 400 401 403 404 409 422 426 429 500 502 504
Detail Human-readable error message
string
errors
Any of:
Array<object>
ValidationErrorItem object Loc Where the validation error occurred
Array
Msg Human-readable validation message
string
Type Machine-readable validation error type
string
Type Stable machine-readable error type
string
Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error
Select media type application/json APIErrorPayload Canonical API error envelope returned by the API.
object Code integer
Allowed values: 400 401 403 404 409 422 426 429 500 502 504
Detail Human-readable error message
string
errors
Any of:
Array<object>
ValidationErrorItem object Loc Where the validation error occurred
Array
Msg Human-readable validation message
string
Type Machine-readable validation error type
string
Type Stable machine-readable error type
string
Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error
Select media type application/json APIErrorPayload Canonical API error envelope returned by the API.
object Code integer
Allowed values: 400 401 403 404 409 422 426 429 500 502 504
Detail Human-readable error message
string
errors
Any of:
Array<object>
ValidationErrorItem object Loc Where the validation error occurred
Array
Msg Human-readable validation message
string
Type Machine-readable validation error type
string
Type Stable machine-readable error type
string
Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error
Select media type application/json APIErrorPayload Canonical API error envelope returned by the API.
object Code integer
Allowed values: 400 401 403 404 409 422 426 429 500 502 504
Detail Human-readable error message
string
errors
Any of:
Array<object>
ValidationErrorItem object Loc Where the validation error occurred
Array
Msg Human-readable validation message
string
Type Machine-readable validation error type
string
Type Stable machine-readable error type
string
Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error
