API referenceWorkflows

Update a workflow step

posthttps://api.expiryedge.com/v1/updateWorkflowStep
bearer token (Firebase ID token or session JWT); role editor or admin60/minAny method
Request
curl -X POST 'https://api.expiryedge.com/v1/updateWorkflowStep?id=stp_9Qm1' \
  -H "Authorization: Bearer $EXPIRYEDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Collect CE certificates (all dentists)",
  "due_offset_days": 10,
  "depends_on": "stp_1Ak5"
}'
Response
{
  "message": "Step updated successfully"
}

Applies the body to the step, except ownership and parent fields (id, organization_id, workflow_id, section_id, run_id, completed_at, ...), which are ignored. Setting status: done stamps completed_at. assignees must be users of your organization. The web app sends PUT; any HTTP method is accepted.

Query parameters

  • idstringrequired
    Step id.

Body parameters

application/json
  • titlestring
  • descriptionstring
  • assigneesarray of string
  • statusstring
  • prioritystring
    Allowedlowmediumhigh
  • start_datestring | null
  • due_datestring | null
  • start_offset_daysinteger | null
  • due_offset_daysinteger | null
  • depends_onstring or array of string | null
  • orderinteger

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.