Create or start workspaces workspaceID workers

Candidate Workspace API. Access depends on the owner cohort and, for Files routes, the Files gate. Check operation state and retained data before assuming a write is durable.

post/v1/workspaces/{workspaceID}/workers

Request

  • Base URL: https://api.plori.ai
  • URL: https://api.plori.ai/v1/workspaces/{workspaceID}/workers
  • Auth: HTTP bearer

Path parameters

workspaceIDstring uuid required

Headers

Idempotency-Keystring

Provide this header or the JSON idempotency_key field. The nonempty header takes precedence when both are set; maximum 255 bytes.

Request body

working_copy_idstring uuid required
task_group_idstring uuid required
taskstring required
executor_agent_idstring uuid
session_idstring
namestring
backendstring
modelstring
configobject
context_selectionobject
idempotency_keystring

Required if Idempotency-Key header is absent. Nonempty header takes precedence.

callback_urlstring
callback_secretstring

Response

Request accepted or completed.

request_idstring required
workspace_idstring required
agent_idstring required
working_copy_idstring required
task_group_idstring required
statusstring required
save_statestring required
reply_statestring required
change_statusstring
base_revisionstring
command_idstring
session_idstring
causestring

Terminal run cause. task_budget_exhausted appears only on runs that ended before task group token figures stopped limiting model calls.

saved_revision_idstring uuid nullable
run_idstring uuid nullable
changeset_idstring uuid nullable
wait_for_replyboolean
saved_operation_idstring uuid

Save operation for this worker run, including when it reuses a revision.

Changes

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