Builder

Bookmark a version as a stable one (or remove the bookmark)

post/builder/sessions/{sessionId}/turns/{turnId}/bookmark

Request

  • Base URL: https://hostingsurge.com/api/v1
  • URL: https://hostingsurge.com/api/v1/builder/sessions/{sessionId}/turns/{turnId}/bookmark
  • Auth: one of:
    • HTTP bearer
    • API key in cookie __Host-hs_session

Path parameters

sessionIdstring uuid required
turnIdstring uuid required

Request body

bookmarkedboolean required

Response

The version

idstring uuid required
seqinteger required
promptstring required
status'queued' | 'running' | 'done' | 'failed' | 'canceled' required
summarystring nullable required

The assistant's chat reply for this turn

modelstring required

The model that produced the final attempt (the stronger model when the turn escalated)

escalatedboolean required

Whether the turn used the stronger (escalation) model

escalation'auto' | 'user' | 'null' nullable required
attemptinteger required

Model calls used, including auto-fix retries

filesChangedinteger required
commitShastring nullable required
kind'chat' | 'manual' | 'restore' | 'code' | 'github' | 'merge' | 'start'

What made the version: chat (default), manual (edits made in the preview), restore, code (code mode), github (from the linked GitHub branch), merge (a draft kept) or start

editCountinteger nullable

manual: the number of preview edits this version collects

bookmarkedboolean

The customer bookmarked this version as a stable one

createdAtstring required

ISO-8601 timestamp

startedAtstring nullable required

ISO-8601 timestamp

finishedAtstring nullable required

ISO-8601 timestamp

Changes

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