---
title: "Delete a record from a named section of a credentialing workflow"
method: DELETE
path: "/credentialing-workflows/{workflowId}/{sectionName}/{recordId}"
tags: ["CredentialingWorkflow"]
---

# Delete a record from a named section of a credentialing workflow

`DELETE /credentialing-workflows/{workflowId}/{sectionName}/{recordId}`

Deletes the section record identified by `recordId` from the specified `sectionName` of the credentialing workflow identified by `workflowId`. The `recordId` format is `{section}-{index}` (e.g. `dea-0`, `licenses-1`). Works for all sections that support record-level CRUD operations. This operation is not idempotent — a second delete for the same `recordId` returns 404.

## Path parameters

- `recordId` string, required
- `sectionName` string, required
- `workflowId` string, required

## Headers

- `tenant-id` string, required

## Request body

- 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`

Record deleted successfully

- object

## Other responses

- `400` — Bad request - Invalid record ID format, section name, or missing deletion metadata
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions
- `404` — Credentialing workflow not found or record not found
- `500` — Internal server error

---

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