Texa Desk Application API · Account

Update account

PATCH/api/v1/accounts/{account_id}

Update account details, settings, and custom attributes

Authorization

api_access_tokenheaderrequired

A person's access token (Texa Desk, Profile settings → Access token) or an agent bot's token, in the api_access_token header. It acts as that person, with their role's permissions.

Path parameters

account_idintegerrequired

The numeric ID of the account

account_idintegerrequired

The numeric ID of the account

Body application/json

namestring

Name of the account

localestring

The locale of the account

domainstring

The domain of the account

support_emailstring

The support email of the account

auto_resolve_afterinteger

Auto resolve conversations after specified minutes

auto_resolve_messagestring

Message to send when auto resolving

auto_resolve_ignore_waitingboolean

Whether to ignore waiting conversations for auto resolve

industrystring

Industry type

company_sizestring

Company size

timezonestring

Account timezone

Responses

200

Success

idnumber

Account ID

namestring

Name of the account

localestring

The locale of the account

domainstring

The domain of the account

support_emailstring

The support email of the account

statusstring

The status of the account

created_atstring (date-time)

The creation date of the account

cache_keysobject

Cache keys for the account

featuresobject

Enabled features for the account

settingsobject

Account settings

settings.auto_resolve_afternumber

Auto resolve conversations after specified minutes

settings.auto_resolve_messagestring

Message to send when auto resolving

settings.auto_resolve_ignore_waitingboolean

Whether to ignore waiting conversations for auto resolve

custom_attributesobject

Custom attributes of the account

custom_attributes.plan_namestring

Subscription plan name

custom_attributes.subscribed_quantitynumber

Subscribed quantity

custom_attributes.subscription_statusstring

Subscription status

custom_attributes.subscription_ends_onstring (date)

Subscription end date

custom_attributes.industrystring

Industry type

custom_attributes.company_sizestring

Company size

custom_attributes.timezonestring

Account timezone

custom_attributes.logostring

Account logo URL

custom_attributes.onboarding_stepstring

Current onboarding step

custom_attributes.marked_for_deletion_atstring (date-time)

When account was marked for deletion

custom_attributes.marked_for_deletion_reasonstring

Reason for account deletion

401

Unauthorized (requires administrator role)

descriptionstring

errorsarray of object

errors[].fieldstring

errors[].messagestring

errors[].codestring

404

Account not found

descriptionstring

errorsarray of object

errors[].fieldstring

errors[].messagestring

errors[].codestring

422

Validation error

descriptionstring

errorsarray of object

errors[].fieldstring

errors[].messagestring

errors[].codestring

curl -X PATCH 'https://desk.texadesk.com/api/v1/accounts/1' \ -H "api_access_token: $TEXA_DESK_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "My Account", "locale": "en", "domain": "example.com" }'

import os, requests headers = {"api_access_token": os.environ["TEXA_DESK_TOKEN"]} body = { "name": "My Account", "locale": "en", "domain": "example.com" } r = requests.patch("https://desk.texadesk.com/api/v1/accounts/1", headers=headers, json=body) r.raise_for_status() print(r.json())

{ "id": 1.0, "name": "string", "locale": "string", "domain": "string", "support_email": "string", "status": "string", "created_at": "2026-10-19T10:00:00Z", "cache_keys": {}, "features": {}, "settings": { "auto_resolve_after": 1.0, "auto_resolve_message": "string", "auto_resolve_ignore_waiting": true }, "custom_attributes": { "plan_name": "string", "subscribed_quantity": 1.0, "subscription_status": "string", "subscription_ends_on": "2026-10-19", "industry": "string", "company_size": "string", "timezone": "string", "logo": "string", "onboarding_step": "string", "marked_for_deletion_at": "2026-10-19T10:00:00Z", "marked_for_deletion_reason": "string" } }