---
title: "Update a sandbox account"
method: PUT
path: "/sandbox/connections/accounts"
tags: ["Sandbox"]
---

# Update a sandbox account

`PUT /sandbox/connections/accounts`

Update an existing sandbox account. Change the connection status to understand how the Finch API responds.

## Request body

- object
  - `connection_status` 'pending' | 'processing' | 'connected' | 'error_no_account_setup' | 'error_permissions' | 'reauth'

## Response `200`

OK

- object
  - `connection_id` string, uuid, required — The ID of the new connection
  - `entity_id` string, uuid, required — The ID of the entity whose status was updated
  - `account_id` string, uuid, required — [DEPRECATED] Use `connection_id` to associate a connection with an access token
  - `authentication_type` 'api_token' | 'assisted' | 'credential' | 'oauth', required
  - `company_id` string, uuid, required — The Finch UUID of the company associated with the `access_token`.
  - `provider_id` string, required — The ID of the provider associated with the `access_token`
  - `products` string[], required

## Changes

> 53 revisions in range; 3 could not be searched.

- **2026-07-15** `4ffde1b7d987` — 1 info
  - response property `company_id` reactivated
- **2026-01-06** `ded87cb73aff` — 2 info
  - the response property `connection_id` became required for the status `200`
  - added the required property `entity_id` to the response with the `200` status
- **2025-08-21** `6d0c6a1feba5` — 1 breaking
  - the `connection_status` request property type/format changed from ``/`` to `string`/``
- **2025-04-22** `46640c1b4688` — 1 info
  - the endpoint scheme security `bearerAuth` was added to the API

[Change history](https://skmtc.dev/finch-api/apis/api-reference/changes/sandbox/connections/accounts/put.md)

---

[API](https://skmtc.dev/finch-api/apis/api-reference.md) · [All operations](https://skmtc.dev/finch-api/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finch-api/api-reference/revisions/f1cca2cb0ef2/schema)