---
title: "PATCH /v1/integrations/{integrationRef}"
method: PATCH
path: "/v1/integrations/{integrationRef}"
tags: ["Integrations"]
---

# PATCH /v1/integrations/{integrationRef}

`PATCH /v1/integrations/{integrationRef}`

## Request

- Base URL: `https://api.tokenbooks.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tokenbooks.io/v1/integrations/{integrationRef}`
- Auth: API key in header `x-api-key`

## Path parameters

- `integrationRef` string, required

## Request body

- UpdateIntegrationRequestDto
  - `priority` integer: Integration priority
  - `name` string: Integration name
  - `logoUrl` string, nullable: Integration logo URL
  - `description` string: Integration description
  - `type` 'BLOCKCHAIN' | 'EXCHANGE' | 'BANK': Integration type
  - `chainId` string, nullable: Linked chain ID
  - `exchangeRequiredCredentials` string, nullable: Required exchange credential metadata
  - `status` 'ACTIVE' | 'ALPHA' | 'BETA' | 'DISABLED': Integration status
  - `isEvm` boolean: Whether the integration is EVM-compatible
  - `mode` 'API' | 'FILE_UPLOAD': Integration mode
  - `processor` string, nullable: Integration processor key

## Response `200`

- IntegrationResponseDto
  - `integrationRef` string, required: Public integration reference
  - `priority` integer, required: Integration display priority
  - `name` string, required: Integration name
  - `logoUrl` string, nullable, required: Integration logo URL
  - `description` string, required: Integration description
  - `type` 'BLOCKCHAIN' | 'EXCHANGE' | 'BANK', required: Integration type
  - `chainId` string, nullable, required: Linked chain ID
  - `chain` object, nullable, required: Linked chain testnet classification
    - `isTestnet` boolean, required
  - `exchangeRequiredCredentials` string, nullable, required: Required exchange credential metadata
  - `status` 'ACTIVE' | 'ALPHA' | 'BETA' | 'DISABLED', required: Integration status
  - `isEvm` boolean, required: Whether the integration is EVM-compatible
  - `mode` 'API' | 'FILE_UPLOAD', required: Integration mode
  - `processor` string, nullable, required: Integration processor key
  - `walletsCount` integer, required: Number of wallets using the linked chain
  - `createdAt` string, date-time, required: Creation timestamp (ISO 8601)
  - `updatedAt` string, date-time, required: Last update timestamp (ISO 8601)

---

[API](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api.md) · [All operations](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/revisions/180622e6255e?raw)