---
title: "Confirm or edit imported engagement details"
method: PATCH
path: "/companies/{companyId}/engagements/{engagementId}"
tags: ["CRM"]
---

# Confirm or edit imported engagement details

`PATCH /companies/{companyId}/engagements/{engagementId}`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/companies/{companyId}/engagements/{engagementId}`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Saves the firm-reviewed display fields while leaving the signed source PDF and original machine-extracted snapshot unchanged. Confirming a new document archives the prior imported engagement for the company.

## Path parameters

- `companyId` string, uuid, required
- `engagementId` string, uuid, required

## Request body

- object
  - `title` string, required
  - `clientName` string, nullable, required
  - `firmName` string, nullable, required
  - `servicesSummary` string, nullable, required
  - `feeAmountCents` integer, nullable, required
  - `billingFrequency` string, nullable, required
  - `effectiveDate` string, date, nullable, required
  - `signedDate` string, date, nullable, required
  - `renewalTerms` string, nullable, required
  - `terminationTerms` string, nullable, required
  - `signerName` string, nullable, required
  - `signerTitle` string, nullable, required
  - `signerEmail` string, email, nullable, required
  - `internalNotes` string, nullable, required
  - `confirmed` unknown, required

## Response `200`

Confirmed imported engagement

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)