Record a status transition event for a credentialing workflow
POST/credentialing-workflows/:workflowId/timeline-events
Creates a new timeline event (status transition) for the credentialing workflow identified by workflowId. This is the primary mechanism for advancing a workflow through its credentialing lifecycle. Call GET /credentialing-workflows/{workflowId}/timeline-events/status-options first to retrieve the set of valid name values (status transitions) available to the current user. Only works on the latest workflow version for a practitioner — returns 409 if a newer version exists. Creating certain events (e.g. triggering PSV generation) may cause asynchronous side effects. To override a completed PSV event, use POST /credentialing-workflows/{workflowId}/override-timeline-events.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 500
- 502
Successfully created the timeline event
Invalid request data
Unauthorized - Authentication required
Forbidden - User does not have required permissions
Credentialing workflow not found
Conflict - Workflow is not the latest version for this practitioner
Internal Server Error - An unexpected error occurred
Downstream service failure