Goldmine
Billing

Update the optional billing profile

POST
/billing.v1.Billing/UpdateBillingProfile

Patches only fields supplied by the caller. The expected version must match the stored version, with zero used for the first write. These fields are ordinary billing contact information and remain self-declared.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/billing.v1.Billing/UpdateBillingProfile" \  -H "Content-Type: application/json" \  -d '{}'
{
  "profile": {
    "addressLine1": "string",
    "addressLine2": "string",
    "billingEmail": "string",
    "businessId": "string",
    "city": "string",
    "countryCode": "string",
    "legalName": "string",
    "postalCode": "string",
    "profileType": "BILLING_PROFILE_TYPE_UNSPECIFIED",
    "taxId": "string",
    "updatedAt": "2019-08-24T14:15:22Z",
    "version": "string",
    "workspaceId": "string"
  }
}
{
  "code": "invalid_argument",
  "message": "The request was malformed, such as a missing required field or an unparseable cursor."
}
{
  "code": "unauthenticated",
  "message": "The request lacks a valid API key in the Authorization header."
}
{
  "code": "permission_denied",
  "message": "The API key is not allowed to perform this action on this workspace."
}
{
  "code": "aborted",
  "message": "The operation was aborted, typically because of a concurrency conflict."
}
{
  "code": "internal",
  "message": "An internal server error occurred."
}

ListBillingTransactions

Returns a bounded keyset page of immutable Goldmine billing transactions at a committed workspace high-water mark. Amounts and running service-credit balances are exact decimal strings. External marketplace spending is separate.

UpdateBillingTerms

Changes the selected workspace payment terms to prepaid or postpaid using compare-and-swap. Neither terms choice creates a subscription or retroactive charges.