Add a note to a credentialing workflow
POST/credentialing-workflows/:workflowId/notes
Creates a new free-text note on the specified credentialing workflow. Use this to record annotations during the credentialing lifecycle; for facility workflows use the Facility Note create endpoint.
Preconditions: request body must contain a non-blank message field; no other fields are accepted. createdBy is set from the caller JWT.
Returns 201 with the created note. Not idempotent — each call creates a distinct note.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 500
- 502
Created note, including server-assigned id and audit fields
Invalid request — blank or null message: validation failures return an ApiError (errors array); ownership mismatches and null-body errors return a BadRequestErrorResponse (errors string array)
Unauthorized - Authentication required
Forbidden - User does not have required permissions
Workflow not found (if returned by downstream services)
Internal Server Error - An unexpected error occurred
Downstream DAL failure (5xx ApiException). Mutating ops normalize to 502; GET ops forward the raw DAL status code.