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

Base URL
https://api.tryscott.ai (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer
TypeScript
https://skmtc.dev/tryscott/apis/one-shot-api/docs/agent-loop/workspaces/post.ts
A function with typed inputs. Its response is checked against the schema.

idstring nullable

namestring required

descriptionstring nullable

modelstring nullable

system_promptstring nullable

initial_doc_contentstring

initial_doc_labelstring

use_local_sandboxboolean

Successful Response

workspace_idstring required

initial_turn_idstring nullable

final_turn_idstring nullable

planspace_urlstring required

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