v1

latestOpenAPI 3.1.02026-08-04156223229.6 KB
agent-loop

Create Workspace

Create a new workspace OR (for Scott pushes) upsert one keyed on (captured_by_user_id, source_kind, source_id).

Two flows:

  • No scott_push: classic workspace creation. Single transaction.
  • With scott_push: idempotent. Same (user, source_kind, source_id) returns the same planspace. Push artifact metadata is replaced in place; scott_push turns are APPENDED past the existing chain tip (never deleted). Non-scott_push turns the user added in the Scott UI are never touched — they stay parented where the user put them and become branches at the prior tip after the next push.
post/agent-loop/workspaces

Request body

idstring nullable
namestring required
descriptionstring nullable
modelstring nullable
system_promptstring nullable
initial_doc_contentstring
initial_doc_labelstring
use_local_sandboxboolean

Response

Successful Response

workspace_idstring required
initial_turn_idstring nullable
final_turn_idstring nullable
planspace_urlstring required