---
title: "Update aggregator connection"
method: PUT
path: "/v1/discovery/aggregator-connections/{id}"
tags: ["Discovery"]
---

# Update aggregator connection

`PUT /v1/discovery/aggregator-connections/{id}`

Edits an existing Open-Finance data-aggregator (Pluggy/Belvo) connection by id so a mistyped baseUrl is not permanent. The vendor is immutable. clientId/secret are optional: supply both to rotate the sealed credential, or omit both to leave the stored secret intact. The supplied credential is sealed before persistence and is never returned. A non-aggregator connection id returns 404.

## Path parameters

- `id` string, required — Opaque aggregator connection id

## Request body

- UpdateAggregatorConnectionRequest
  - `accountRef` string, required — Opaque vendor account reference (Pluggy itemId, Belvo link id) the webhook pull threads onto its request
  - `baseUrl` string, uri, required — Vendor API base URL, stored as the connection host
  - `clientId` string — Aggregator API client id (optional; supply with secret to rotate, omit both to keep the stored credential; sealed; never emitted)
  - `configName` string, required — Unique connection config name (tenant-scoped); the mint endpoint binds a token to this name
  - `secret` string — Aggregator API client secret (optional; supply with clientId to rotate, omit both to keep the stored credential; sealed; never emitted)

## Response `200`

OK

- AggregatorConnectionResponse
  - `accountRef` string, required — Stored opaque vendor account reference (Pluggy itemId, Belvo link id)
  - `baseUrl` string, uri, required — Stored vendor API base URL
  - `configName` string, required — Connection config name the operator mints a token against
  - `vendor` 'pluggy' | 'belvo', required — Aggregator vendor the connection is bound to

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)