Create or start workspaces workspaceID changesets

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}/changesets

Request

  • Base URL: https://api.plori.ai
  • URL: https://api.plori.ai/v1/workspaces/{workspaceID}/changesets
  • 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

base_revisionstring uuid required
incoming_revisionstring uuid required
expected_current_revisionstring uuid required
idempotency_keystring

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

incoming_save_operation_idstring uuid

Save operation for the selected proposal. Preserve this ID when the proposal reuses a revision and when repeating a comparison.

Response

See the response body and resource state; asynchronous work requires polling.

idstring uuid required
workspace_idstring uuid required
statestring required
phasestring required
source_working_copy_idstring uuid required
base_revisionstring uuid required
incoming_revisionstring uuid required
requested_expected_revisionstring uuid required
comparison_current_revisionstring uuid
result_revisionstring uuid
integration_working_copy_idstring uuid
validation_evidencestring[]
integration_write_generationinteger required
root_write_generationinteger required
incoming_save_operation_idstring uuid

Save operation for the selected proposal.

auto_accept'pending' | 'accepted' | 'abandoned'

Present only for a changeset whose comparison with the Workspace was clean and changed files. pending: Plori may still accept it. accepted: Plori accepted it. abandoned: Plori stopped and will not accept it.

Changes

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