billing.account.updateChange the company name, invoice address, VAT ID or invoice e-mail
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
companyNameRequiredstring
The name on the invoice: the company’s, or the person’s; 2–200 characters
Constraints: 2-200 chars
vatNumberOptionalstring
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
addressLine1Requiredstring
Street and number, 2–200 characters
Constraints: 2-200 chars
addressLine2Optionalstring
Second address line, at most 200 characters; empty or omitted: none
Constraints: max 200 chars
postalCodeRequiredstring
Postal code in the country’s own format (DE: five digits), at most 20 characters
Constraints: 1-20 chars
cityRequiredstring
City, 1–100 characters
Constraints: 1-100 chars
countryRequiredstring
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}$/
billingEmailOptionalobject
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 examplecurl -X PATCH "https://console.platform.deutschecloud.app/billing/api/account" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY" \
-H "Content-Type: application/json" \
-d '{"companyName":"example","addressLine1":"example","postalCode":"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.