> ## Documentation Index > Fetch the complete documentation index at: https://docs.quentli.com/llms.txt > Use this file to discover all available pages before exploring further. # Update invoice > Updates editable fields of an existing invoice by id. ## OpenAPI ````yaml /openapi.yaml patch /v1/invoices/{id} openapi: 3.0.3 info: title: Quentli REST API version: 1.0.0 description: OpenAPI spec for Quentli REST endpoints. servers: - url: https://api.quentli.com description: Production API - url: https://api.staging.quentli.com description: Staging API for production-like validation - url: https://api.demo.quentli.com description: Demo API hostname served by staging security: - organizationApiKey: [] tags: - name: Auth - name: Billing - name: Catalog - name: Customers - name: Invoices - name: Payment Methods - name: Payment Sessions - name: Payments - name: Subscriptions - name: Tax Invoices - name: Webhooks paths: /v1/invoices/{id}: patch: tags: - Invoices summary: Update invoice description: Updates editable fields of an existing invoice by id. operationId: invoices_update parameters: - schema: type: string description: Identifier of the invoice. required: true description: Identifier of the invoice. name: id in: path requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateInvoiceArgs' responses: '200': description: Invoice updated content: application/json: schema: $ref: '#/components/schemas/UpdateInvoicePayload' '400': description: Invalid request content: application/json: schema: $ref: '#/components/schemas/UserError' '401': description: Authentication required content: application/json: schema: $ref: '#/components/schemas/UserError' '403': description: Permission denied content: application/json: schema: $ref: '#/components/schemas/UserError' '404': description: Invoice not found content: application/json: schema: $ref: '#/components/schemas/UserError' components: schemas: UpdateInvoiceArgs: type: object properties: input: type: object properties: data: type: object properties: dueDate: anyOf: - type: string description: Date string - type: string format: date-time description: Date object expireDate: anyOf: - type: string description: Date string - type: string format: date-time description: Date object - nullable: true collectionMethod: type: string enum: - AUTOMATIC - SEND_REMINDER - NONE beneficiaryId: type: string nullable: true metadata: type: array items: type: object properties: key: type: string minLength: 1 value: type: string nullable: true required: - key meta: type: object additionalProperties: type: string nullable: true items: type: array items: type: object properties: conceptId: type: string nullable: true concept: type: object nullable: true properties: displayName: type: string amount: type: number currency: type: string required: - displayName - amount - currency quantity: type: number minimum: 1 amount: type: number nullable: true minimum: 0 maximum: 99999999999 currency: type: string nullable: true description: type: string nullable: true minLength: 1 required: - quantity minItems: 1 maxItems: 100 modifiers: type: array items: type: object properties: modifierId: type: string required: - modifierId discounts: type: array items: type: object properties: discountId: type: string required: - discountId additionalProperties: false additionalProperties: false required: - data required: - input description: Request body for updating an invoice (id is provided in the URL path). UpdateInvoicePayload: type: object properties: invoice: $ref: '#/components/schemas/Invoice' required: - invoice description: Successful invoice update response. UserError: type: object properties: error: type: object properties: message: type: string required: - message required: - error additionalProperties: false description: Standard user-facing error response envelope. Invoice: type: object properties: id: type: string description: Unique identifier of the invoice. example: inv_1234567890abcdefghij createdAt: anyOf: - type: string description: Date string - type: string format: date-time description: Date object description: Date and time when the invoice was created. example: '2025-01-10T12:00:00.000Z' updatedAt: anyOf: - type: string description: Date string - type: string format: date-time description: Date object description: Date and time when the invoice was last updated. example: '2025-01-10T12:00:00.000Z' customerId: type: string description: Identifier of the customer this invoice belongs to. example: cus_1234567890abcdefghij subscriptionId: type: string nullable: true description: Identifier of the subscription that generated this invoice, if any. example: sub_1234567890abcdefghij collectionMethod: type: string enum: - AUTOMATIC - SEND_REMINDER - NONE description: 'How payment is collected: AUTOMATIC, SEND_REMINDER, or NONE.' example: SEND_REMINDER totalAmount: type: number description: Computed total amount of the invoice in minor units. example: 150000 currency: type: string description: ISO 4217 currency code for the invoice. example: MXN dueDate: anyOf: - type: string description: Date string - type: string format: date-time description: Date object description: Date and time when payment is due. example: '2025-02-01T06:00:00.000Z' expireDate: anyOf: - type: string description: Date string - type: string format: date-time description: Date object - nullable: true description: Date and time when the invoice expires. example: null organizationId: type: string description: Identifier of the organization that owns this invoice. example: org_1234567890abcdefghij isPaid: type: boolean description: Whether the invoice has been fully paid. example: false paidById: type: string nullable: true description: Identifier of the customer who paid the invoice. example: null amountPaid: type: number description: Total amount paid so far in minor units. example: 0 beneficiaryId: type: string nullable: true description: Identifier of the beneficiary customer, if any. example: null allowOfftimePayment: type: boolean description: Whether payment is accepted outside the due window. example: false paidWithId: type: string nullable: true description: Identifier of the payment that settled the invoice. example: null canceledAt: anyOf: - type: string description: Date string - type: string format: date-time description: Date object - nullable: true description: Date and time when the invoice was canceled. example: null canceledById: type: string nullable: true description: Identifier of the user who canceled the invoice. example: null items: type: array items: $ref: '#/components/schemas/InvoiceItem' description: Line items included in this invoice. example: - id: invi_1234567890abcdefghij description: Colegiatura Enero 2025 conceptId: pc_1234567890abcdefghij concept: null quantity: 1 meta: type: object nullable: true additionalProperties: type: string description: Flattened metadata map where each key maps to a string value. example: Ciclo Escolar: 2025-1 required: - id - createdAt - updatedAt - customerId - subscriptionId - collectionMethod - totalAmount - currency - dueDate - expireDate - organizationId - isPaid - paidById - amountPaid - beneficiaryId - allowOfftimePayment - paidWithId - canceledAt - canceledById - items description: Invoice record representing a payment request sent to a customer. InvoiceItem: type: object properties: id: type: string description: Unique identifier of the invoice item. example: invi_1234567890abcdefghij description: type: string description: Human-readable description of the line item. example: Colegiatura Enero 2025 conceptId: type: string nullable: true description: Identifier of the payment concept for this item. example: pc_1234567890abcdefghij quantity: type: number minimum: 1 description: Quantity of units for this line item. example: 1 required: - id - description - conceptId - quantity description: A single line item within an invoice. securitySchemes: organizationApiKey: type: http scheme: bearer description: 'Organization API key using `Authorization: Bearer sk_...`.' ````