API referenceWorkflows

Set a workflow step status

posthttps://api.expiryedge.com/v1/updateWorkflowStepStatus
bearer token (Firebase ID token or session JWT); role editor or admin60/minAny method
Request
curl -X POST 'https://api.expiryedge.com/v1/updateWorkflowStepStatus?id=stp_9Qm1' \
  -H "Authorization: Bearer $EXPIRYEDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "done"
}'
Response
{
  "message": "Step status updated successfully"
}

done stamps completed_at; any other value clears it. Recomputes the workflow progress. The web app sends PUT; any HTTP method is accepted.

Query parameters

  • idstringrequired
    Step id.

Body parameters

application/json
  • statusstringrequired

Returns

200
Success.
  • messagestringrequired

Errors

400
The request is missing required fields or contains invalid values.
401
Missing, expired or invalid bearer token.
403
Authenticated, but your role or organization does not allow this action.
404
The record does not exist or is not in your organization.
429
Too many requests for this endpoint from your IP. Wait Retry-After seconds.
500
Unexpected server error. Retry later; quote requestId to support.