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

# Replace all supporting documents on a facility workflow

`PUT /facility-credentialing-workflows/{workflowId}/supporting-documents`

Replaces the entire supporting documents array for the specified facility credentialing workflow with the provided list (replace-all / desired-state semantics). **When to use:** Supply the complete desired list of supporting documents. Documents not included in the request will be removed. To clear all supporting documents, send an empty array `[]`. To append a new document without affecting others, use `POST /facility-credentialing-workflows/{workflowId}/supporting-documents`. **Preconditions:** The workflow must belong to the caller's tenant. **Returns:** `200 OK` with the updated supporting documents. Returns `404` if the workflow is not found.

## Path parameters

- `workflowId` string, required

## Headers

- `tenant-id` string, required

## Request body

- FacilitySupportingDocumentUpdateRequest[]
  - `fileUrl` string, required — URL of the supporting document file
  - `fileType` string, required — Type of the supporting document
  - `originalFileName` string, required — Original name of the uploaded file
  - `createdAt` string — Date when the document was created
  - `createdBy` string — The user who created the record
  - `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

## Response `200`

Supporting documents updated successfully

- object

## Other responses

- `400` — Bad request - Invalid input or validation error
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions
- `404` — Facility credentialing workflow not found
- `500` — Internal server error

---

[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)