billing.account.update

Change the company name, invoice address, VAT ID or invoice e-mail

PATCH /billing/api/accountIAM billing:UpdateBillingAccountChanges state

Applies to invoices issued from now on; issued invoices keep what they said. A changed VAT ID is checked for its member state’s format and against VIES: one VIES does not know is refused (400, field vatNumber); when VIES cannot be reached the ID is saved with vatNumberStatus unavailable, every later save checks it again until VIES confirms it, and until then invoices treat it as no VAT ID (no reverse charge for an EU customer outside Germany; a German customer pays German VAT either way). country is one of the listed ISO codes; postalCode must fit that country (DE: five digits). Send every field. billingEmail is recorded for invoice e-mails, which are not sent yet.

Request syntax

PATCH /billing/api/account
{
  "companyName": "string",
  "vatNumber": "string",
  "addressLine1": "string",
  "addressLine2": "string",
  "postalCode": "string",
  "city": "string",
  "country": "string",
  "billingEmail": "object"
}

Request body

  • companyNameRequired

    string

    The name on the invoice: the company’s, or the person’s; 2–200 characters

    Constraints: 2-200 chars

  • vatNumberOptional

    string

    EU VAT ID (USt-IdNr.) with its two-letter prefix, e.g. DE123456789; at most 20 characters, spaces, dots and hyphens are removed. Checked for its member state’s format, then against VIES. Empty or omitted: no VAT ID, German VAT is charged

    Constraints: max 20 chars

  • addressLine1Required

    string

    Street and number, 2–200 characters

    Constraints: 2-200 chars

  • addressLine2Optional

    string

    Second address line, at most 200 characters; empty or omitted: none

    Constraints: max 200 chars

  • postalCodeRequired

    string

    Postal code in the country’s own format (DE: five digits), at most 20 characters

    Constraints: 1-20 chars

  • cityRequired

    string

    City, 1–100 characters

    Constraints: 1-100 chars

  • countryRequired

    string

    ISO 3166-1 alpha-2 country code from the console’s country list, e.g. DE; any other two letters are refused

    Constraints: /^[A-Za-z]{2}$/

  • billingEmailOptional

    object

    Invoice e-mail address (recorded; invoice e-mails are not sent yet). Also receives the monthly cost report by default. At sign-up, empty or omitted means the account’s e-mail; on PATCH /billing/api/account it means none

    Constraints: JSON

Response

200 with the billing account as `get` shows it, after the change. 400 with field vatNumber for a VAT ID of the wrong format or one VIES does not know.

A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow billing:UpdateBillingAccount on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud billing account update --company-name example --address-line1 example --postal-code example --city example --country example

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_billing_account_update.