Update financial account

Financial Account Token

Schema

financial_account_token:
- uuid: required
- nickname: string (length ≤ 256)

Response Codes

200 OK
- object
  - token: uuid, required and a globally unique identifier for the account
  - created: date-time, required
  - updated: date-time, required
  - type:
    - Instance Financial Account Type
    - Account Financial Account Type (required)
  - routing_number: string | null
  - account_number: string | null
  - nickname: string | null (required)
  - account_token: uuid | null (required)
  - status: string, enum (required)
    - Status of the financial account: OPEN, CLOSED, SUSPENDED, PENDING
  - substatus: null (Financial Account Substatus, required)
  - user_defined_status: string | null (required)
    - User-defined status for the financial account
  - is_for_benefit_of: boolean (required)
    - Whether financial account is for the benefit of another entity
  - credit_configuration: object | null (required)
    - credit_limit: integer | null (required)
    - external_bank_account_token: uuid | null (required)
    - credit_product_token: string | null (required)
      - Globally unique identifier for the credit product
    - tier: string | null (required)
      - Tier assigned to the financial account
    - auto_collection_configuration: null (Auto Collection Configuration Response, required)

Error Responses

400 A parameter in the query does not match valid queries for the endpoint.
401 User has not been authenticated.
404 The specified resource was not found.
422 Unprocessable entity.
429 Client has exceeded the number of allowed requests.

Example Request

curl --request PATCH \
     --url https://sandbox.lithic.com/v1/financial_accounts/financial_account_token \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{\n  "nickname": "string"\n}'

Example Response

{
  "token": "b68b7424-aa69-4cbc-a946-30d90181b621",
  "created": "2026-07-18T00:25:32.840Z",
  "updated": "2026-07-18T00:25:32.840Z",
  "type": "ISSUING",
  "routing_number": "string",
  "account_number": "string",
  "nickname": "string",
  "account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "OPEN",
  "substatus": "CHARGED_OFF_DELINQUENT",
  "user_defined_status": "string",
  "is_for_benefit_of": true,
  "credit_configuration": {
    "credit_limit": 0,
    "external_bank_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "credit_product_token": "string",
    "tier": "string",
    "auto_collection_configuration": {
      "auto_collection_enabled": true
    }
  }
}