---
title: "Replace all state licenses on a facility workflow"
method: PUT
path: "/facility-credentialing-workflows/{workflowId}/licenses"
tags: ["FacilityCredentialingWorkflow"]
---

# Replace all state licenses on a facility workflow

`PUT /facility-credentialing-workflows/{workflowId}/licenses`

Replaces the entire state licenses list for the specified facility credentialing workflow with the array provided in the request body. **When to use:** Supply the complete desired list — omitting an existing item removes it. To clear all state licenses, send an empty array `[]`. **Preconditions:** The workflow must belong to the caller's tenant. **Returns:** `200 OK` with the updated workflow section. Returns `404` if the workflow is not found, `400` if the request body is invalid.

## Path parameters

- `workflowId` string, required

## Headers

- `tenant-id` string, required

## Request body

- FacilityStateLicenseUpdateRequest[]
  - `type` string — The type of license
  - `expirationDate` string, required — Expiration date of the license
  - `issueDate` string — Issue date of the license
  - `licenseNumber` string, required — License number
  - `state` string, required — State where license was issued
  - `licenseType` string, required — Type of license
  - `licenseStatus` string, required — Status of the license
  - `licenseSource` string, required — Source of the license information
  - `reportDate` string, required — Report date
  - `licenseNumberVariations` string — Variations of the license number
  - `flaggedDate` string — Date when license was flagged
  - `dataSource` string — Data source for the license
  - `url` string — URL for license verification
  - `createdAt` string — Date when the record was created
  - `createdBy` string — User who created the record
  - `updatedAt` string — Date when the record was last updated
  - `updatedBy` string — User who last updated the record
  - `attachments` FacilityCredentialingWorkflowAttachment[] — Supporting documents for the license
    - `createdAt` string — The date the attachment was created
    - `fileType` string, required — Supporting Document File Type (i.e. Malpractice Insurance Policy, License, etc.)
    - `fileUrl` string, required — Supporting Document File URI in GCS
    - `originalFileName` string, required — Supporting Document Original File Name
    - `state` string — The state associated with the supporting document
    - `expirationDate` string — The expiration date of the supporting document
    - `source` string — The source of the supporting document
    - `createdBy` string — The user who created the record
    - `updatedAt` string — The date the attachment was last updated
    - `updatedBy` string — The user who last updated the record
  - `verifiedDate` string — Date when license was verified
  - `verifiedBy` string — Person who verified the license

## Response `200`

State licenses updated successfully

## Other responses

- `400` — Invalid request
- `404` — Workflow not found

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/563848e0ecc0/schema)