Update Developer Connections

put

https://tenants-gateway-api-sbx.sidedrawersbx.com/api/v1/tenants/marketplace/tenant/tenant-id/{tenantId}/connections/connection-id/{connectionId}

Path Params

tenantId

string

required

Tenant identifier.

connectionId

string

required

Connection identifier that was authorized.

Body Params

name

string

required

length between 1 and 100

Human-readable name for the connection.

brandCode

string

length between 2 and 20

The affiliate code (brandCode) is an identifier for the "brand" or "affiliate" within a Tenant. The affiliate code is the version of the brand name that appears in the URL. A brand name may be "Corporate ABC", for example. Then the affiliate code might be something like "corporate-abc".

connectionType

string

enum

Defaults to client_credentials

Type of OAuth2 flow or authentication method to use.

Allowed:

identityProvider

string

enum

Defaults to keycloak

Identity provider used. Default: Auth0.

Allowed:

method

string

enum

HTTP method used for token requests (typically POST).

Allowed:

clientId

string

length between 1 and 255

Client identifier or App Key provided by the service for OAuth2 authentication.

clientSecret

string

length between 1 and 255

Client Secret or App Secret provided by the service. This will be encrypted at rest.

tokenUrl

uri

OAuth2 token endpoint URL where access tokens are requested.

scope

string

length ≤ 500

OAuth2 scope parameter defining the level of access requested.

customParams

object

Additional OAuth2 parameters that may be required by specific providers.

apiKey

string

length between 1 and 255

API Key for simple API key-based authentication (alternative to OAuth2).

logo

uri

length ≤ 500

Logo URL for the connection. Will be displayed as a 20x20px square icon in the UI.

Response

201

The Connection has been successfully updated.

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here!