Bind Custody Provider

post

https://example.com/custody/bind

Define a new custody provider integration. Only one custody provider is supported at a time.

Body Params

name

string

required

.*\S.*

A unique name for the custody provider. This name will be used to reference the provider in other API calls

endpoint

string

required

.*\S.*

address of custody adapter in host:port format

auth

array

List of authentication mechanisms supported by this ledger

auth

idempotency

object

Idempotency configuration to prevent duplicate request processing

retryStrategy

object

Per-binding retry policy for the external adapter's WORKFLOW-layer handling of transient (technical) errors. When omitted, the service falls back to the global retry defaults (prior behavior). transientErrorsMaxRetries and transientErrorsUnlimitedRetries are mutually exclusive; set at most one.

displayName

string

.*\S.*

display name

requestTimeout

string

required

length ≥ 1

^[1-9]\d*(?:\.\d+)?(h|m|s|ms|us|µs|ns)(\d+(?:\.\d+)?(h|m|s|ms|us|µs|ns))*$

request timeout (e.g. 300s)

backoff

string

required

length ≥ 1

^[1-9]\d*(?:\.\d+)?(h|m|s|ms|us|µs|ns)(\d+(?:\.\d+)?(h|m|s|ms|us|µs|ns))*$

backoff (e.g. 60s)

singleRequestTimeout

string

required

length ≥ 1

^[1-9]\d*(?:\.\d+)?(h|m|s|ms|us|µs|ns)(\d+(?:\.\d+)?(h|m|s|ms|us|µs|ns))*$

single request timeout (e.g. 90s)

Responses

200

successful operation

400Bad Request

500Internal Server Error