latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

CredentialingWorkflow

Queue bulk workflow creation via Cloud Tasks with tracking (v2)

Accepts a bulk workflow creation request, writes a tracking record to the database, and enqueues one Cloud Tasks task per practitioner for reliable, independent processing. Returns 202 immediately with the bulk request tracking ID. Poll the tracking record or check individual workflow creation results using the tracking ID. Each task calls POST /credentialing-workflows/cloud-create internally. Use this endpoint in preference to the v1 /bulk-create when you need per-item status tracking or retry guarantees via Cloud Tasks.

post/credentialing-workflows/v2/bulk-create

Headers

tenant-idstring required

Tenant ID

Request body

certifyPractitionerIdsstring[]

List of certify practitioner IDs to create workflows for. Required when isSelectAll is false. Ignored when isSelectAll is true (practitioner IDs will be fetched using the filter).

filterstring

Filter criteria as JSON string (URL encoded). Used to find practitioners when isSelectAll is true. Practitioner IDs from matching practitioners will be used to create new workflows. See GET /practitioners endpoint documentation for filter format. Filterable fields include: data.npi, data.firstName, data.lastName.

isSelectAllboolean

If true, find all practitioners matching the filter criteria and create workflows for those practitioners, instead of using certifyPractitionerIds. When true, filter parameter is required and certifyPractitionerIds will be ignored.

Example request

{
  "certifyPractitionerIds": [
    "cp_123456",
    "cp_789012"
  ],
  "filter": "{\"data.npi\":{\"eq\":\"1234567890\"}}"
}

Response

Bulk workflow creation request accepted. Individual workflows will be created via Cloud Tasks.

object required