well_update_invoice
ActiveTool of Well
declared in 1.0.0
Update an existing invoice in Well. Call well_get_schema("invoices") to discover all available fields. REQUIRED: invoice_id OPTIONAL (only pass fields you want changed): - reference_number, issue_date (ISO date), due_date (ISO date) - status (draft | issued | paid | canceled) - terms, description - grand_total, items_total, tax_total (numbers) - local_currency (ISO 4217 three-letter code, e.g. "EUR", "USD") - document_type_code (UN/CEFACT 1001 code, e.g. "380") - billing_context (e.g. subscription, one_time, project, ...) - issuer_company_id / receiver_company_id (uuid to set, null to clear, omit to leave unchanged) Cannot change line items, payment_means, or document attachment via this tool.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"invoice_id"
],
"properties": {
"terms": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "null"
}
],
"description": "Payment terms text; pass null to clear"
},
"status": {
"enum": [
"draft",
"issued",
"paid",
"canceled"
],
"type": "string",
"description": "Invoice lifecycle status"
},
"due_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Payment due date (ISO 8601); pass null to clear"
},
"tax_total": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Total tax amount; pass null to clear"
},
"invoice_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The UUID of the invoice to update"
},
"issue_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Issue date (ISO 8601, e.g. 2026-04-27); pass null to clear"
},
"description": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "null"
}
],
"description": "Free-form description; pass null to clear"
},
"grand_total": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Total invoice amount including tax; pass null to clear"
},
"items_total": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Sum of line items before tax; pass null to clear"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Target workspace. Omit to use the only authorized workspace, or (for read tools) to query all authorized workspaces grouped by workspace. Required for write tools when the token authorizes more than one workspace."
},
"local_currency": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{3}$",
"maxLength": 3,
"minLength": 3
},
{
"type": "null"
}
],
"description": "ISO 4217 three-letter currency code (e.g. EUR, USD); pass null to clear"
},
"payment_status": {
"enum": [
"unpaid",
"partial",
"paid",
"overpaid"
],
"type": "string",
"description": "User-driven payment_status override — requires override_version (CAS)"
},
"billing_context": {
"anyOf": [
{
"enum": [
"subscription",
"recurring",
"periodic",
"installment",
"retainer",
"usage_based",
"consumption",
"metered",
"volume_based",
"overage",
"project",
"milestone",
"hourly",
"fixed_price",
"time_materials",
"one_time",
"event_based",
"commission",
"bonus",
"reimbursement",
"maintenance",
"support",
"consulting",
"training",
"professional_services",
"contract",
"license",
"rental",
"lease",
"franchise",
"adjustment",
"refund",
"credit",
"penalty",
"discount",
"deposit",
"advance_payment",
"escrow",
"insurance",
"tax",
"promotional",
"trial",
"freemium",
"setup",
"activation",
"other",
"mixed",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Billing context / business model; pass null to clear"
},
"idempotency_key": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Optional client-supplied key. A retried write with the same key returns the original result instead of re-applying the operation."
},
"override_version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Required when payment_status is present — current override_version for CAS"
},
"reference_number": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"description": "Invoice reference number (e.g. INV-2026-001); pass null to clear"
},
"issuer_company_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
],
"description": "Issuer company UUID. Omit = no change, null = clear, uuid = set."
},
"document_type_code": {
"anyOf": [
{
"enum": [
"220",
"221",
"222",
"230",
"231",
"232",
"235",
"236",
"270",
"271",
"310",
"311",
"312",
"315",
"320",
"322",
"325",
"326",
"327",
"328",
"329",
"380",
"381",
"383",
"384",
"385",
"386",
"387",
"388",
"389",
"390",
"391",
"392",
"393",
"394",
"395",
"396",
"397",
"440",
"441",
"446",
"447",
"450",
"451",
"452",
"456",
"460",
"550",
"551",
"552",
"610",
"611",
"612",
"615",
"617",
"618",
"619",
"622",
"623",
"700",
"701",
"702",
"705",
"740",
"741",
"743",
"770",
"775",
"805",
"810",
"815",
"820",
"825",
"830",
"835",
"840",
"845",
"850",
"999"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "UN/CEFACT 1001 document type code (e.g. 380 for commercial invoice); pass null to clear"
},
"receiver_company_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
],
"description": "Receiver company UUID. Omit = no change, null = clear, uuid = set."
}
},
"additionalProperties": false
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Well
https://github.com/WellApp-ai/well-mcp
1/7 registries