PATCH /organizations/:organization_id/sso-connection

svc-org-management_other

Update SSO connection configuration

patch/organizations/{organization_id}/sso-connection

Path parameters

organization_idstring required

Organization ID or label identifier

Organization ID or label

Headers

X-Client-Request-IDstring uuid

Unique request identifier specified by the originating caller and passed along by proxies.

Request body

identifierstring

SSO provider identifier (e.g., issuer URL)

client_idstring

OAuth 2.0 client ID (set to null to remove)

client_secretstring

OAuth 2.0 client secret (set to null to remove)

Response

SSO connection updated successfully

idstring required

Unique identifier for the SSO connection

identifierstring required

SSO provider identifier (e.g., issuer URL)

client_idstring nullable required

OAuth 2.0 client ID

client_secret_setboolean required

Whether a client secret is configured

created_atstring date-time required

The time the entity was created in utc

updated_atstring date-time required

The time the entity was mostly recently updated in utc

permissionsOrgManagementPermissions

Permissions granted to the authenticated principal for this resource. Only populated when the 'expand[]=permissions' query parameter is provided. Keys are resource types (e.g., "organizations"), values are objects mapping permission names to boolean values indicating if the permission is granted.

Example response

{
  "permissions": {
    "organizations": {
      "read": true,
      "update": true
    },
    "users": {
      "read": true,
      "list": true
    }
  }
}

Changes

Changed in 3 of the 23 revisions of this API.111

Aug 26, 2026d65d51379d936See the full diff
- ○
  added the new optional request property protocols/oauth2/authorization_parameters
  new-optional-request-property
- ○
  added the new optional request property protocols/openid/scopes
  new-optional-request-property
- ○
  added the new optional request property protocols/openid/user_identifier_claim
  new-optional-request-property
- ○
  added the optional property protocols/oauth2/authorization_parameters to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property protocols/openid/scopes to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property protocols/openid/user_identifier_claim to the response with the 200 status
  response-optional-property-added
Mar 16, 2026d3d69f45bfed3See the full diff
- ○
  the endpoint scheme security OAuth2 was added to the API
  api-security-added
- ○
  the endpoint scheme security bearerAuth was added to the API
  api-security-added
- ○
  the endpoint scheme security org-management_bearerAuth was removed from the API
  api-security-removed
This revision also has 8 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 6, 2026edd1b760a98912See the full diff
- ●
  deleted the header request parameter X-Request-ID
  request-parameter-removed
- ○
  the endpoint scheme security org-management_bearerAuth was added to the API
  api-security-added
- ○
  the endpoint scheme security svc-org-management_bearerAuth was removed from the API
  api-security-removed
This revision also has 82 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history