---
title: "Update credentialing-date fields on a CRED_APPROVED timeline event"
method: PATCH
path: "/facility-credentialing-workflows/{workflowId}/timeline-events/{eventId}"
tags: ["FacilityCredentialingWorkflow"]
---

# Update credentialing-date fields on a CRED_APPROVED timeline event

`PATCH /facility-credentialing-workflows/{workflowId}/timeline-events/{eventId}`

Partially updates an existing `CRED_APPROVED` timeline event and its associated workflow in a single atomic transaction. **When to use:** Use to record or correct the next credentialing date after a `CRED_APPROVED` event has been created. This endpoint only works for events of type `CRED_APPROVED` — requests for other event types will be rejected. **Updatable fields** (all optional in a given call): `nextCredentialingDate`, `nextCredentialingDateSource`, `changeReason`, `nextCredentialingDateChangeLog`. **Side effects:** Both the timeline event and the associated workflow document are updated atomically within a single transaction. **Returns:** `200 OK` with the updated timeline event and workflow fields. Returns `400` if the event type is not `CRED_APPROVED` or if business rules are violated.

## Path parameters

- `eventId` string, required
- `workflowId` string, required

## Headers

- `tenant-id` string, required

## Request body

- UpdateFacilityTimelineEventRequest
  - `nextCredentialingDate` string, date
  - `nextCredentialingDateSource` string
  - `changeReason` string
  - `nextCredentialingDateChangeLog` NextCredDateChangeLogEntry1[]
    - `changedFrom` string, date
    - `changedTo` string, date
    - `changeReason` string

## Response `200`

Successfully updated the timeline event

- FacilityTimelineEventResponse
  - `id` string
  - `workflowId` string
  - `createdBy` string
  - `createdAt` string, date
  - `updatedAt` string, date
  - `updatedBy` string
  - `data` FacilityTimelineEventschema
    - `credentialingDecisionDate` string, date, required
    - `nextCredentialingDate` string, date, required
    - `nextCredentialingDateSource` 'SYSTEM_CALCULATED' | 'USER_INPUT'
    - `changeReason` string, required
    - `psvPdfPath` string
    - `nextCredentialingDateChangeLog` FacilityCredApprovedNextCredentialingDateChangeLogInner[]
      - `changedFrom` string, date, required
      - `changedTo` string, date, required
      - `changeReason` string, required
      - `createdBy` string, required
      - `createdAt` string, date, required
    - `isOverride` boolean
    - `overrideReason` string

## Other responses

- `400` — Invalid request data or business rule violation
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - User does not have required permissions
- `404` — Timeline event or facility credentialing workflow not found
- `500` — Internal Server Error - An unexpected error occurred

---

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