E099: Adjust inventory

POST /api/materials-inventory/adjustments

Records found stock — an upward count correction to materials on-hand. Triggered from the Materials Inventory page, "Adjust". ADJUST is positive-only ("I counted more than the ledger said"); reductions and write-offs go through E100 Dispose.

Authentication

Standard tenant route. Requires Authorization: Bearer <firebase-id-token> and X-Org-Id: <org-id>. Access: Admin. Also reachable with an org-scoped PAT.

Request

{
  "materialId": "uuid",
  "locationId": "uuid",
  "quantity": 10,
  "notes": "cycle count",
  "eventDate": "2026-06-10T00:00:00Z"
}

quantity must be positive. notes and eventDate are optional.

Response — 201 Created

{
  "id": "uuid",
  "code": "MIL-003",
  "materialId": "uuid",
  "locationId": "uuid",
  "eventType": "ADJUST",
  "quantity": "10",
  "ref": null,
  "sourceType": null,
  "sourceId": null,
  "createdAt": "2026-06-10T00:00:00Z"
}

A manual ADJUST row. ref is null, and the row carries no provenance (sourceType / sourceId both null).

Errors

HTTP	code	Condition
404	not_found	Material or location not found.
422	validation_failed	quantity is not positive (use a disposal to reduce inventory).

Workflow

Calls W099 Adjust inventory.