Update a stage

PUT

https://app.hustro.com/api/v2/project/{projectId}/workflow/{workflowId}/stage/{stageId}

OperationId:updateStage

Updates fields on an existing workflow stage. Missing fields are left unchanged (PATCH semantics).

Approval semantics:

Setting approvalType to null disables approval; the backend automatically clears requiredApprovals (or accept an explicit null).

When approvalType is set and approvers are provided, approvers.length must be in [1, 10].

requiredApprovals (optional): integer in [1, approvers.length]. Pass null to clear; omit to leave unchanged. The backend clamps automatically: if approvers shrinks below the current n, n is reduced to match the new approver count.

Cross-field rule: requiredApprovals cannot be set when approvalType is null.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Workflow with the updated stage

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://app.hustro.com/api/v2/project//workflow//stage/' \
--header 'hustro-client: m2m' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Alison Reinger",
    "icon": "construction",
    "approvalType": "sequential",
    "approvers": [
        {
            "userId": "b5caaca5Fc3Afd0008c2f28a"
        }
    ]
}'

Response Example

{
    "_id": "string",
    "name": "string",
    "stages": [
        {
            "_id": "string",
            "isDeleted": true,
            "order": "string",
            "name": "string",
            "icon": "description",
            "approvalType": "parallel",
            "approvers": [
                {
                    "userId": "string",
                    "order": "string"
                }
            ],
            "requiredApprovals": 1,
            "deadlineDays": 0,
            "autoApprove": true
        }
    ],
    "isLocked": true
}

Create a stage in a workflow

Delete a stage