[ expenses ]

Update an expense

Change an expense created by this credential. An agent cannot alter a person's or another agent's expense.

PATCH/api/v1/expenses/{id}

Response

application/json

Fields

idstringrequired

Public expense ID beginning with exp_.

merchantstring

Replacement merchant name.

amountnumber

Replacement major-unit amount.

amount_centsinteger

Replacement integer-cent amount.

currencystring

Replacement ISO currency.

categorystring

Replacement natural-language category.

occurred_ondate

Replacement ISO date.

notesstring

Replacement note or null.

Request

curl -X PATCH 'https://www.agentcents.com/api/v1/expenses/exp_01J...' \
  -H 'Authorization: Bearer ac_live_YOUR_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{"notes":"Team coffee"}'

Response

{
  "data": {
    "id": "exp_01J...",
    "amount_cents": 650,
    "currency": "USD",
    "amount_display": "$6.50",
    "merchant": "Blue Bottle",
    "category": "Coffee & Cafes",
    "occurred_on": "2026-09-20",
    "notes": null,
    "status": "posted",
    "source": {
      "type": "agent",
      "transport": "api",
      "key_id": "key_01J...",
      "connection_id": null
    },
    "has_receipt": false,
    "created_at": "2026-09-20T12:00:00Z",
    "updated_at": "2026-09-20T12:00:00Z"
  },
  "category_resolved": {
    "match_type": "fuzzy",
    "match_confidence": 0.83,
    "suggested_categories": []
  }
}