Set one of a connection's sealed fields, never shown again; empty clears it: your workspace's owner

PUT

/v1/buyer/connections/{id}/secrets/{field}

curl --request PUT \
  --url https://example.com/v1/buyer/connections/example/secrets/example \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "value": "example" }'

Who: a workspace’s owner. Not for API keys.

Authorizations

• bearer

Parameters

Path Parameters

id

required

string

field

required

string

Request Body^required

Media typeapplication/json

object

value

required

string

Example ^generated

{
  "value": "example"
}

Responses

200

OK

Media typeapplication/json

object

data

required

Array<object>

object

last4

required

string

name

required

string

set

required

boolean

updated_at

required

string | null format: date-time

Example ^generated

{
  "data": [
    {
      "last4": "example",
      "name": "example",
      "set": true,
      "updated_at": "2026-04-15T12:00:00Z"
    }
  ]
}

default

An error, as go-commons apperr maps it

Media typeapplication/json

object

error

required

object

code

required

string

fields

object

key

additional properties

string

message

required

string

Example ^generated

{
  "error": {
    "code": "example",
    "fields": {
      "additionalProperty": "example"
    },
    "message": "example"
  }
}