Sign in

v1

latestOpenAPI 3.1.02026-08-04156223229.6 KB
artifacts

Create Document Artifact

Land an agent write_document turn — as a suggestion or a committed node.

Dispatched per actor by _suggestions_enabled_for:

  • enabled (allowlisted user, or any non-prod env) -> suggestion flow (_land_suggestion); no node minted.
  • disabled (prod, non-allowlisted) -> pre-Phase-1 flow (_land_committed_node); mint a committed node.

Both share the dual-auth contract from require_turn_access_from_body.

post/workspaces/{workspace_id}/document-artifacts

Path parameters

workspace_idstring required

Headers

authorizationstring nullable

Request body

idstring required
turn_idstring required
labelstring nullable
initial_markdownstring required

Response

Successful Response

idstring required
workspace_idstring required
namestring nullable required
produced_at_turn_idstring required
created_atstring date-time required