---
title: "Update the specified Engagement"
method: PATCH
path: "/v1/engagements/{uuid}"
tags: ["engagements"]
---

# Update the specified Engagement

`PATCH /v1/engagements/{uuid}`

## Path parameters

- `uuid` string, uuid, required

## Request body

- EngagementUpdate
  - `engagement_lead_user_uuid` string, uuid — The UUID of the firm user who is the engagement lead
  - `identifier` string, nullable — An external identifier that can be used by integrated systems
  - `status` 'Pending' | 'In Progress' | 'Complete' — The status of the Engagement
  - `name` string — The name of the Engagement

## Response `200`

The updated Engagement data

- object
  - `data` EngagementRead, required
    - `uuid` string, uuid, required
    - `name` string, required
    - `status` 'Pending' | 'In Progress' | 'Complete' | 'Archived', required — The engagement's current lifecycle status.
    - `is_template` boolean, required — Whether this is a reusable engagement template rather than a live engagement.
    - `company_uuid` string, uuid, required — UUID of the client company this engagement is for.
    - `start_date` string, date, nullable, required — The engagement's planned start date, or null if not scheduled.
    - `end_date` string, date, nullable, required — The engagement's planned end date, or null if not scheduled.
    - `created_at` string, date-time, required
    - `report_issue_date` string, date, nullable, required — The date the audit report was issued, or null if not yet issued.
    - `engagement_lead_user_uuid` string, uuid, nullable, required — UUID of the user leading the engagement (the audit lead), or null if no engagement lead is available.
    - `client_owner_user_uuid` string, uuid, nullable, required — UUID of the client-side owner of the engagement, or null if unassigned.
    - `identifier` string, nullable — An external identifier that can be used by integrated systems
    - `_links` EngagementReadLinks, required
      - `fieldguide` HalLink, required
        - `href` string, uri, required
        - `title` string — A human-readable title for the link
        - `type` string, required — The content-type

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden (requires scopes `engagements:write`)
- `404` — Resource not found
- `429` — Too many requests

---

[API](https://skmtc.net/fieldguide/apis/fieldguide-api.md) · [All operations](https://skmtc.net/fieldguide/apis/fieldguide-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fieldguide/fieldguide-api/revisions/6f6009a58cdd/schema)