latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

FacilityCredentialingWorkflow

Assign a facility credentialing workflow to a user

Creates an assignment record for the specified facility credentialing workflow, associating it with the given user and appending an entry to the assignment history. When to use: Use to assign (or reassign) a single workflow to one user. To assign multiple workflows at once, use POST /facility-credentialing-workflows/assignments. Preconditions: The caller must hold the FACILITY_CREDENTIALING_WORKFLOW_ASSIGN or ASSIGN_SELF permission. The target user must have the required permissions to be assigned; if not, 422 Unprocessable Entity is returned — select a different assignee or ensure the target user's permissions are elevated. Side effects: An assignment history entry (FacilityAssignmentHistoryResponse) is created. Returns: 201 Created with the new FacilityAssignmentHistoryResponse in the body.

post/facility-credentialing-workflows/{id}/assignments

Path parameters

idstring required

ID of the facility credentialing workflow

Headers

tenant-idstring required

Tenant ID

Request body

assignedTostring

User ID being assigned to

reasonstring

Optional reason for the assignment

Example request

{
  "assignedTo": "user_123456",
  "reason": "Load balancing"
}

Response

Successfully created the assignment

workflowIdstring

Unique identifier for the facility credentialing workflow

tenantIdstring

ID of the tenant

tenantFacilityIdstring

ID of the tenant facility

Example response

{
  "workflowId": "1234",
  "tenantId": "tenant_123456",
  "tenantFacilityId": "tf_123456",
  "assignments": [
    {
      "assignedFrom": "user_123456",
      "assignedTo": "user_789012",
      "assignedBy": "user_345678",
      "assignedOn": "2021-01-01T00:00:00Z",
      "reason": "Load balancing"
    }
  ]
}