---
title: "Update a counterparty"
method: PATCH
path: "/counterparties/{id}"
tags: ["Counterparties"]
---

# Update a counterparty

`PATCH /counterparties/{id}`

## Request

- Base URL: `https://api.catena.com/v1`
- URL: `https://api.catena.com/v1/counterparties/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string
  - `email` string, email, nullable

## Response `200`

Counterparty updated

- object
  - `counterparty` object, required
    - `id` string, required
    - `name` string, required
    - `email` string
    - `createdAt` string, date-time, required
    - `rails` union[], required
      - union
        - object
          - `id` string, required
          - `counterpartyId` string, required
          - `createdAt` string, date-time, required
          - `source` 'platform' | 'counterparty', required
          - `type` 'bank', required
          - `bankName` string, required
          - `routingNumber` string, required
          - `accountNumber` string, required
          - `accountType` 'checking' | 'savings'
          - `address` string
          - `addressStreet` string
          - `addressCity` string
          - `addressState` string
          - `addressPostalCode` string
          - `addressCountry` string
          - `providerExternalAccountId` string
        - object
          - `id` string, required
          - `counterpartyId` string, required
          - `createdAt` string, date-time, required
          - `source` 'platform' | 'counterparty', required
          - `type` 'wallet', required
          - `walletAddress` string, required
          - `network` 'base' | 'base-sepolia' | 'arc' | 'arc-testnet' | 'solana', required
          - `preferredNetwork` 'base' | 'base-sepolia' | 'arc' | 'arc-testnet' | 'solana'
          - `disabledNetworks` string[]
    - `status` 'ready' | 'awaiting_details', required
    - `invite` object
      - `state` 'outstanding' | 'expired', required
      - `expiresAt` string, required
      - `methods` object, required
        - `bank` boolean, required
        - `wallet` boolean, required
      - `onchainNetwork` 'base' | 'base-sepolia' | 'arc' | 'arc-testnet' | 'solana'

## Changes

- **2026-09-29** `75eb76762c83`: 4 warning
  - added the new `arc-testnet` enum value to the `counterparty/invite/onchainNetwork` response property for the response status `200`
  - added the new `arc-testnet` enum value to the `counterparty/rails/items/oneOf[subschema #2]/disabledNetworks/items/` response property for the response status `200`
  - added the new `arc-testnet` enum value to the `counterparty/rails/items/oneOf[subschema #2]/network` response property for the response status `200`
  - added the new `arc-testnet` enum value to the `counterparty/rails/items/oneOf[subschema #2]/preferredNetwork` response property for the response status `200`
- **2026-09-23** `5627a43ac484`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/catena/apis/catena-api/changes/counterparties/:id/patch.md)

---

[API](https://skmtc.dev/catena/apis/catena-api.md) · [All operations](https://skmtc.dev/catena/apis/catena-api/llms.txt) · [OpenAPI document](https://skmtc.dev/catena/apis/catena-api/revisions/852257e39bf8?raw)