Skip to main content
PUT
/
managed_accounts
/
{managed_account_token}
Update managed account
curl --request PUT \
  --url https://api.vantage.sh/v2/managed_accounts/{managed_account_token} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "contact_email": "<string>",
  "access_credential_tokens": [
    "<string>"
  ],
  "billing_rule_tokens": [
    "<string>"
  ],
  "email_domain": "<string>",
  "msp_billing_profile_token": "<string>",
  "payment_terms_days": 123,
  "include_managed_account_integrations": true,
  "billing_information_attributes": {
    "id": 123,
    "token": "<string>",
    "company_name": "<string>",
    "country_code": "<string>",
    "address_line_1": "<string>",
    "address_line_2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postal_code": "<string>",
    "billing_email": [
      "<string>"
    ]
  },
  "business_information_attributes": {
    "id": 123,
    "token": "<string>",
    "metadata": {
      "custom_fields": [
        {
          "name": "<string>",
          "value": "<string>"
        }
      ]
    }
  }
}
'
{
  "token": "acct_dd2fdf6564b60319",
  "name": "New Name",
  "contact_email": "newguy@acme.com",
  "parent_account_token": "acct_bb022aecd1125ada",
  "access_credential_tokens": [
    "accss_crdntl_686904ffd39a4618"
  ],
  "billing_rule_tokens": [],
  "email_domain": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.vantage.sh/llms.txt

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

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

managed_account_token
string
required

Body

application/json

Update a Managed Account.

name
string

The name of the Managed Account.

contact_email
string

The contact email address for the Managed Account.

access_credential_tokens
string[]

Access Credential (aka Integrations) tokens to assign to the Managed Account.

billing_rule_tokens
string[]

Billing Rule tokens to assign to the Managed Account.

email_domain
string

Email domain to associate with this Managed Account for SSO.

msp_billing_profile_token
string

Token of the MSP billing profile to use for this managed account (MSP invoicing accounts only).

payment_terms_days
integer<int32>

Number of days until payment is due after invoice date (MSP invoicing accounts only). Defaults to 10.

include_managed_account_integrations
boolean

Whether to include managed account's own integrations in invoice cost calculations (MSP invoicing accounts only). Defaults to false.

billing_information_attributes
object

Billing address and contact information (MSP invoicing accounts only)

business_information_attributes
object

Business information and custom fields (MSP invoicing accounts only)

Response

ManagedAccount model

token
string
required
name
string
required
contact_email
string
required
parent_account_token
string
required

The token for the parent Account.

access_credential_tokens
string[]
required

The tokens for the Access Credentials assigned to the Managed Account.

billing_rule_tokens
string[]
required

The tokens for the Billing Rules assigned to the Managed Account.

email_domain
string | null

Email domain associated with this Managed Account for SSO.

msp_billing_profile_token
string | null

Token of the MSP billing profile used for this managed account (MSP invoicing accounts only)

payment_terms_days
integer<int32> | null

Number of days until payment is due after invoice date (MSP invoicing accounts only)

include_managed_account_integrations
boolean | null

Whether to include managed account's own integrations in invoice cost calculations (MSP invoicing accounts only)

billing_information_attributes
object
business_information_attributes
object