v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB

Discovery

Update aggregator connection

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.

put/v1/discovery/aggregator-connections/{id}

Path parameters

idstring required

Opaque aggregator connection id

Request body

accountRefstring required

Opaque vendor account reference (Pluggy itemId, Belvo link id) the webhook pull threads onto its request

baseUrlstring uri required

Vendor API base URL, stored as the connection host

clientIdstring

Aggregator API client id (optional; supply with secret to rotate, omit both to keep the stored credential; sealed; never emitted)

configNamestring required

Unique connection config name (tenant-scoped); the mint endpoint binds a token to this name

secretstring

Aggregator API client secret (optional; supply with clientId to rotate, omit both to keep the stored credential; sealed; never emitted)

Example request

{
  "accountRef": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "baseUrl": "https://api.pluggy.ai",
  "configName": "pluggy-main"
}

Response

accountRefstring required

Stored opaque vendor account reference (Pluggy itemId, Belvo link id)

baseUrlstring uri required

Stored vendor API base URL

configNamestring required

Connection config name the operator mints a token against

vendor'pluggy' | 'belvo' required

Aggregator vendor the connection is bound to

Example response

{
  "accountRef": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "baseUrl": "https://api.pluggy.ai",
  "configName": "pluggy-main",
  "vendor": "pluggy"
}