Add a step to a workflow section

posthttps://api.expiryedge.com/v1/createWorkflowStep
bearer token (Firebase ID token or session JWT); role editor or admin60/minJede Methode
Anfrage
curl -X POST 'https://api.expiryedge.com/v1/createWorkflowStep' \
  -H "Authorization: Bearer $EXPIRYEDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "section_id": "sec_5Hn2",
  "workflow_id": "wf_3Kd9Tx",
  "title": "Collect CE certificates",
  "assignees": [
    "u_71bXq"
  ],
  "priority": "high",
  "due_date": "2026-10-15"
}'
Antwort
{
  "message": "Step created successfully",
  "step_id": "stp_9Qm1",
  "step": {
    "id": "stp_9Qm1",
    "section_id": "sec_5Hn2",
    "workflow_id": "wf_3Kd9Tx",
    "title": "Collect CE certificates",
    "description": "Gather continuing education certificates from each dentist.",
    "assignees": [
      "u_71bXq"
    ],
    "status": "todo",
    "priority": "high",
    "start_date": null,
    "due_date": null,
    "due_offset_days": 7,
    "completed_at": null,
    "order": 0,
    "dependencies": [],
    "time_estimate": 0,
    "time_spent": 0,
    "tags": [],
    "linked_expiry_id": null,
    "created_at": "2026-09-27T14:05:00.000Z"
  }
}

assignees must be users of your organization (400 with details.assignees otherwise). New steps start as todo; order defaults to the end of the section.

Body-Parameter

application/json
  • section_idstringerforderlich
  • workflow_idstringerforderlich
  • titlestringerforderlich
  • descriptionstring
  • assigneesarray of string
    User ids.
  • start_datestring
    Calendar date YYYY-MM-DD in the organization's timezone.
  • due_datestring
    Calendar date YYYY-MM-DD in the organization's timezone.
  • prioritystring
    ErlaubtlowmediumhighStandard medium
  • orderinteger

Rückgabe

201
Created.
  • messagestringerforderlich
  • step_idstringerforderlich
  • stepobjecterforderlich
    A step of a workflow template. Extra keys set through updateWorkflowStep are stored and returned as-is.

Fehler

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.