---
title: "Replace all addresses on a credentialing workflow"
method: PUT
path: "/credentialing-workflows/{workflowId}/addresses"
tags: ["CredentialingWorkflow"]
---

# Replace all addresses on a credentialing workflow

`PUT /credentialing-workflows/{workflowId}/addresses`

Replaces the entire addresses array on the credentialing workflow identified by `workflowId` with the provided list (full-replacement PUT semantics). Any address currently on the workflow that is not included in the request body will be removed. Send an empty array (`[]`) to remove all addresses.

## Path parameters

- `workflowId` string, required

## Headers

- `tenant-id` string, required

## Request body

- AddressUpdateRequest[]
  - `createdAt` string, date
  - `createdBy` string — The user who created the record
  - `updatedAt` string, date
  - `updatedBy` string — The user who last updated the record
  - `address1` string, required — Address Line 1
  - `address2` string — Address Line 2
  - `city` string, required — City
  - `state` string, required — State
  - `country` string — Country
  - `zipcode` string, required — Zipcode
  - `source` string — Source of the address
  - `type` string, required — Type of the address
  - `deletion` DeleteSectionRecordRequest — Metadata required when soft-deleting a credentialing section record.
    - `intent` string — Deletion intent. Null is accepted when the soft-delete modal is disabled and intent is not collected from the user.
    - `reason` string — Deletion reason. Null is accepted when the soft-delete modal is disabled and reason is not collected from the user.
    - `reasonText` string — Free-text explanation; required when reason is OTHER. Max 2000 characters.

## Response `200`

Addresses updated successfully

- object

## Other responses

- `400` — Bad request - Invalid input or validation error
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions
- `404` — 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)