---
title: "Update account"
method: PATCH
path: "/accounts"
tags: ["Account Management"]
---

# Update account

`PATCH /accounts`

## Request

- Base URL: `https://api.quiva.ai`
- URL: `https://api.quiva.ai/accounts`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/docs/accounts/patch.ts> (a function with typed inputs; its response is checked against the schema)

Updates account information.
 - An update can be made to any of the non-critical editable account properties only by root and admin users.
 - Critical account properties such as name, ID, and root email address cannot be changed with this request
 - To update *name*, see **/accounts/rename**
- To update *root_email*, see **/accounts/request-email-address-change**

## Request body

- UpdateAccountRequest
  - `country` string: Country
  - `company_name` string: Company name
  - `address` string: Address
  - `website` string: Website
  - `phone_number` string: Phone number
  - `onboarding_progress` object: Onboarding progress
  - `region` string: Region
  - `provider` string: Provider
  - `cloud` boolean: Cloud enabled
  - `hub` boolean: Hub enabled

## Response `200`

Account updated successfully

- object
  - `data` AccountPublicInfo, required
    - `name` string: Account name (normalized)
    - `id` string: Account unique identifier - 10 digits
    - `display_name` string: Account display name
    - `root_email` string, email: Root user email address
    - `subscription_status` 'active' | 'pending' | 'cancelled': Subscription status
    - `subscription_plan` string: Subscription plan
    - `emergency_credit` number, float: Emergency credit amount
    - `country` string: Country
    - `company_name` string: Company name
    - `address` string: Address
    - `website` string: Website
    - `phone_number` string: Phone number
    - `scheduled_for_deletion` boolean: Whether the account is scheduled for deletion
    - `deletion_date` string, date-time: If the account is scheduled for deletion, it will be deleted on this date
    - `region` string: Region
    - `provider` string: Provider
    - `bstier` integer: BS tier
    - `cloud` boolean: Cloud functionality enabled. It true, the user has access to quiva.ai Cloud
    - `hub` boolean: Hub functionality enabled. It true, the user has access to quiva.ai Hub

## Other responses

- `400`: Bad request
- `401`: Unauthorized

## Changes

- **2025-06-12** `4979dfd00eda`: 19 warning, 1 info
  - removed the optional property `address` from the response with the `200` status
  - removed the optional property `bstier` from the response with the `200` status
  - removed the optional property `cloud` from the response with the `200` status
  - removed the optional property `company_name` from the response with the `200` status
  - …16 more

[Operation history](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/changes/accounts/patch.md)

---

[API](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway.md) - [All operations](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/revisions/700eb1ace61a?raw)