---
title: "Update Instance"
method: PUT
path: "/v1/instances/{id}"
tags: ["Instances"]
---

# Update Instance

`PUT /v1/instances/{id}`

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string — Optional key to safely retry this request without performing the action twice. Retrying with the same key and an identical body replays the original response; reusing a key with a different body returns an error. Keys are kept for 24 hours.

## Request body

- UpdateInstanceIn
  - `name` string, required
  - `customer_invite_redirect_url` string, uri, nullable
  - `email_notifications` boolean — Whether email notifications are enabled for this instance
  - `require_passkey` boolean — Whether passkey verification is required for protected actions
  - `compliance_emails` string[], nullable — When non-empty, compliance Request for Information emails are sent only to these addresses instead of all instance members
  - `customer_rfi_emails_enabled` boolean — Whether customer (customer) Request for Information notification emails are sent for this instance. Omit to leave unchanged.

## Response `200`

Instance updated

- Success
  - `success` boolean, required

## Other responses

- `400` — Possible error codes: `VALIDATION_FAILED`. See the Error responses section for retry semantics.
- `401` — Possible error codes: `AUTH_UNAUTHORIZED`. See the Error responses section for retry semantics.
- `403` — Possible error codes: `AUTH_FORBIDDEN`. See the Error responses section for retry semantics.
- `429` — Possible error codes: `AUTH_RATE_LIMITED`. See the Error responses section for retry semantics.
- `500` — Possible error codes: `INTERNAL_ERROR`. See the Error responses section for retry semantics.

---

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