Skip to navigation

Apply a workstream and deploy to an environment

Validate the source workstream, merge it into the environment, deploy its AI configuration and record deployment metadata. Requires changes.approve AND deploy.live for live, otherwise deploy.test. This is a real deployment, with no dry-run flag. A 409 merge conflict requires updating the workstream from the target and resolving it before retrying. A deployment failure may occur after the Git merge; inspect the environment and error before retrying.

Required permissions: changes.approve, deploy.live for live; deploy.test otherwise.

Authentication

AuthorizationBearer

Kinde access token with the configured LogicDialog audience and workspace membership/permissions. Channel API keys cannot authenticate management operations.

Path parameters

workspaceIdstringRequired
changeIdstringRequired

Query parameters

branchstringOptional

Explicit workstream branch. Writes reject main/live. Example: change/WORKSPACE/knowledge-update.

Request

This endpoint expects an object.
environmentIdstringRequired
commentstringOptional

Response

Merge, providerDeploy, deploymentRecord and workstreamUpdate results

Errors

401
Unauthorized Error
403
Forbidden Error
409
Conflict Error
422
Unprocessable Entity Error