Skip to main content
PATCH
cURL

Authorizations

Authorization
string
header
required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

org_id
string
required
provider_id
string
required

Body

application/json

Update a connection. All fields optional; absent = unchanged. client_secret is write-only — supply it only to rotate.

allowed_domains
string[] | null
client_id
string | null
client_secret
string | null
display_name
string | null
enabled
boolean | null
groups_claim
string | null
issuer
string | null
scopes
string | null

Response

Updated connection

Masked view of a connection. Never includes the client secret.

allowed_domains
string[]
required
client_secret_set
boolean
required

Whether a client secret is configured. The secret itself is never returned.

created_at
integer<int64>
required
enabled
boolean
required
enforced
boolean
required

Read-only here: SSO enforcement isn't configurable via the API yet.

id
string
required
kind
string
required
org_id
string
required
provider_key
string
required
updated_at
integer<int64>
required
client_id
string | null

OIDC client id. null for non-OIDC kinds.

default_role_id
string | null

Catch-all role granted to JIT members with no matching group mapping. null = no catch-all role.

display_name
string | null
groups_claim
string | null
issuer
string | null

OIDC issuer. null for non-OIDC kinds (e.g. SAML), whose connection details live in kind-specific fields added when those kinds ship.

scopes
string | null