Skip to main content
PUT
Update aggregator connection

Authorizations

Authorization
string
header
required

Bearer token authentication (format: "Bearer {token}")

Path Parameters

id
string
required

Opaque aggregator connection id

Body

application/json
accountRef
string

Opaque vendor account reference (Pluggy itemId, Belvo link id). Supply it to bind (or re-bind) the connection after the vendor's consent widget returns one; omit it to leave the stored value untouched.

Example:

"a1b2c3d4-5678-90ab-cdef-1234567890ab"

baseUrl
string<uri>

Vendor API base URL, stored as the connection host. Omit it to leave the stored URL untouched.

Example:

"https://api.pluggy.ai"

clientId
string

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

configName
string

Unique connection config name (tenant-scoped); the mint endpoint binds a token to this name. Omit it to leave the stored name untouched.

Example:

"pluggy-main"

secret
string

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

Response

OK

accountRef
string
required

Stored opaque vendor account reference (Pluggy itemId, Belvo link id); empty while the connection is awaiting consent

Example:

"a1b2c3d4-5678-90ab-cdef-1234567890ab"

Whether the connection is still awaiting the end customer's vendor consent (no vendor item/link bound yet)

Example:

false

baseUrl
string<uri>
required

Stored vendor API base URL

Example:

"https://api.pluggy.ai"

configName
string
required

Connection config name the operator mints a token against

Example:

"pluggy-main"

vendor
enum<string>
required

Aggregator vendor the connection is bound to

Available options:
pluggy,
belvo
Example:

"pluggy"