Create a workflow type

posthttps://api.expiryedge.com/v1/createWorkflowType
editor or admin60/minAny method
Request
curl -X POST 'https://api.expiryedge.com/v1/createWorkflowType' \
  -H "Authorization: Bearer $EXPIRYEDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Licensing",
  "description": "License and permit renewals",
  "color": "#1976d2"
}'
Response
{
  "id": "wtype_R4c2",
  "name": "Licensing",
  "description": "License and permit renewals",
  "color": "#1976d2",
  "organization_id": "org_northwind",
  "created_by": "u_71bXq",
  "created_at": "2026-09-27T14:05:00.000Z",
  "updated_at": "2026-09-27T14:05:00.000Z"
}

Names are unique within the organization (400 on duplicate). color defaults to #1976d2. Authentication failures currently return 500 {error} from this handler, not 401.

Body parameters

application/json
  • namestringrequired
  • descriptionstring
  • colorstring
    Hex color.
    Default #1976d2

Returns

201
Created.
  • idstringread-only
  • namestring
  • descriptionstring
  • colorstring
  • organization_idstringread-only
  • created_bystringread-only
  • created_atstring
    ISO 8601 date-time string (UTC). Formerly a raw Firestore Timestamp ({_seconds, _nanoseconds}).
    format: date-time
  • updated_atstring
    ISO 8601 date-time string (UTC). Formerly a raw Firestore Timestamp ({_seconds, _nanoseconds}).
    format: date-time
  • workflow_countintegerread-only

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.
429
Too many requests for this endpoint from your IP. Wait Retry-After seconds.
500
Unexpected server error. Retry later; quote requestId to support.