Bulk upload supporting documents to multiple practitioners
POST/practitioners/supporting-documents/bulk
Uploads one or more files exactly once each and links them as shared supporting-document attachments (source: "Bulk") to every selected practitioner. Practitioners may be selected explicitly via certifyPractitionerIds (JSON string form field), or via isSelectAll=true plus a filter JSON string (same encoding as GET /practitioners). When isSelectAll is true, certifyPractitionerIds is ignored; when false, filter is ignored. Target set size is capped (default 1000; see api-layer.practitioner.bulk-document-upload.max-practitioners). HTTP 200 is returned for both full and partial success: per-file and per-practitioner outcomes are reported independently in the response body. When the feature kill switch is off, the endpoint returns 404 with an empty body (CP-32986).
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 500
Bulk upload processed (full or partial success); see body for per-file and per-practitioner outcomes
Bad request - missing files/fileType, invalid certifyPractitionerIds/filter JSON, no practitioners resolved, or too many practitioners targeted. Body shape is {"error": "
Unauthorized - Authentication required
Forbidden - Insufficient permissions
Not Found - bulk supporting-document upload is disabled for this environment (empty body)
Internal server error. Body shape is {"error": "