---
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 — The ID of the new connection
  - `account_id` string, uuid, required — [DEPRECATED] Use `connection_id` to associate a connection with an access token
  - `authentication_type` 'credential' | 'api_token' | 'oauth' | 'assisted', required
  - `company_id` string, uuid, required — [DEPRECATED] Use `connection_id` to associate a connection with an access token
  - `provider_id` string, required — The ID of the provider associated with the `access_token`
  - `products` string[], required

## Changes

- **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/e8b684dbd61d/schema)