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

# Replace all contact emails on a credentialing workflow

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

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

## Path parameters

- `workflowId` string, required

## Headers

- `tenant-id` string, required

## Request body

- EmailUpdateRequest[]
  - `createdAt` string, date
  - `createdBy` string — The user who created the record
  - `updatedAt` string, date
  - `updatedBy` string — The user who last updated the record
  - `email` string, required — Email address
  - `emailType` string, required — Type of email
  - `source` string — Source of the email
  - `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`

Emails updated successfully

- object

## Other responses

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