A workflow definition is the versioned blueprint that the AlgaPSA workflow engine runs. Use this API to author drafts, manage metadata, and publish versions.
Create a definition with POST /workflow-definitions, edit a draft at PUT /workflow-definitions/{workflowId}/{version}, then promote it with POST /workflow-definitions/{workflowId}/{version}/publish. Visibility, pause state, and failure thresholds are set via the metadata endpoint, and /import ingests a legacy v1 bundle. Start runs from a published definition with the Workflow Runs API.
Every endpoint links through to its full parameters, request and response schemas, and code samples.
GET/api/workflow-definitionsAlgaPSAList workflow definitionsPOST/api/workflow-definitionsAlgaPSACreate workflow definitionGET/api/workflow-definitions/{workflowId}/{version}AlgaPSAGet a workflow versionPUT/api/workflow-definitions/{workflowId}/{version}AlgaPSAUpdate workflow draft definitionPOST/api/workflow-definitions/{workflowId}/{version}/publishAlgaPSAPublish a workflow versionGET/api/workflow-definitions/{workflowId}/auditAlgaPSAGet workflow audit logGET/api/workflow-definitions/{workflowId}/audit/exportAlgaPSAExport workflow audit logGET/api/workflow-definitions/{workflowId}/exportAlgaPSAExport a workflow definitionPUT/api/workflow-definitions/{workflowId}/metadataAlgaPSAUpdate workflow metadataGET/api/workflow-definitions/{workflowId}/versionsAlgaPSAList workflow versionsPOST/api/workflow-definitions/importAlgaPSAImport a v1 workflow bundle