# company.applyRecord

Save chosen facts of a kept company record into the company profile, replacing what is there, with documentId, fields (legalName, operatingName, businessNumber, corporationNumber, incorporationDate, jurisdiction, registration, gstHstAccount, gstHstEffectiveDate, gstHstFrequency, fiscalYearEnd, registeredOffice, directors, officers, shareholders), the profile's expectedRevision and idempotencyKey. Each saved fact notes the record as its source.

`POST /api/v1/accounting/company.applyRecord`

Permissions: `accounting:read`, `accounting:write`, `accounting:admin` · Roles: admin · Idempotency key required · Send `expectedRevision`

MCP tool: `accounting_company_apply_record`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `expectedRevision` | integer | Yes | The record's current revision, from the last time you read it. If someone changed the record since, the request is refused with a conflict so you can reload and check before trying again. 0 to 9007199254740991. |
| `idempotencyKey` | string | Yes | Any unique text you generate once per intended change, so a retried request only happens once. Send it as the Idempotency-Key header instead if you prefer; if you send both they must match. 8–200 characters. |
| `documentId` | string (ID) | Yes | The ID of the related record. |
| `fields` | array of enum values | Yes | One of: `legalName`, `operatingName`, `businessNumber`, `corporationNumber`, `incorporationDate`, `jurisdiction`, `entityCountry`, `formationJurisdiction`, `legalForm`, `usFederalTaxClassification`, `registration`, `gstHstAccount`, `gstHstEffectiveDate`, `gstHstFrequency`, `fiscalYearEnd`, `registeredOffice`, `directors`, `officers`, `shareholders`. 1–19 items. |

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/company.applyRecord \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "expectedRevision": 3,
  "documentId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "fields": [
    "legalName"
  ]
}'
```

Reference page: https://app.getoatmilk.com/docs/api/company.applyRecord