Skip to main content
PATCH
/
workspaces
/
{workspaceId}
/
billing-accounts
/
{billingAccountId}
Update a billing account
curl --request PATCH \
  --url https://v1.api.altostrat.io/workspaces/{workspaceId}/billing-accounts/{billingAccountId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "ACME Corp (International)",
  "email": "global.billing@acme.com",
  "phone": "+15559876543",
  "description": "Primary account for all international billing.",
  "address": {
    "country": "US",
    "line1": "123 Main Street",
    "line2": "Suite 456",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105"
  }
}
'
{
  "id": "cus_a1b2c3d4e5f6g7h8",
  "workspace_id": "ws_a1b2c3d4e5f6g7h8",
  "name": "ACME Corp Billing",
  "email": "billing@acme.com",
  "phone": "+15551234567",
  "description": "For US-based operations",
  "currency": "usd",
  "address": {
    "country": "US",
    "line1": "123 Main Street",
    "line2": "Suite 456",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105"
  },
  "created_at": "2025-10-29T00:40:06.000000Z",
  "updated_at": "2025-10-29T00:40:06.000000Z"
}

Documentation Index

Fetch the complete documentation index at: https://altostrat.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Enter your JWT in the format: Bearer {token}

Path Parameters

​
workspaceId
string
required

The ID of the workspace.

Example:

"ws_a1b2c3d4e5f6g7h8"

​
billingAccountId
string
required

The ID of the billing account, which corresponds to a Stripe Customer ID (cus_...).

Example:

"cus_a1b2c3d4e5f6g7h8"

Body

application/json
​
name
string

The new name for the billing account.

Example:

"ACME Corp (International)"

​
email
string<email>

The new primary billing email address.

Example:

"global.billing@acme.com"

​
phone
string | null

The new billing contact phone number.

Example:

"+15559876543"

​
description
string | null

An updated description for the billing account.

Example:

"Primary account for all international billing."

​
address
object

Response

The updated billing account object.

​
id
string

Unique identifier for the billing account (Stripe Customer ID), prefixed with cus_.

Example:

"cus_a1b2c3d4e5f6g7h8"

​
workspace_id
string

The ID of the workspace this billing account belongs to.

Example:

"ws_a1b2c3d4e5f6g7h8"

​
name
string

The name of the billing account.

Example:

"ACME Corp Billing"

​
email
string<email>

The primary billing email address.

Example:

"billing@acme.com"

​
phone
string | null

The billing contact phone number.

Example:

"+15551234567"

​
description
string | null

An optional description for the billing account.

Example:

"For US-based operations"

​
currency
enum<string>

The three-letter ISO currency code for the billing account.

Available options:
usd,
zar,
eur,
gbp,
aud
Example:

"usd"

​
address
object
​
created_at
string<date-time>

The timestamp when the billing account was created.

Example:

"2025-10-29T00:40:06.000000Z"

​
updated_at
string<date-time>

The timestamp when the billing account was last updated.

Example:

"2025-10-29T00:40:06.000000Z"