Update SSO

  • PATCH
  • /workspaces
  • /:domain
  • /sso

Updates SSO in the workspace.

Request

REQUIRED SCOPES
WORKSPACE
URL PARAMETERS
domainrequired string
The workspace domain.
POST PARAMETERS
typestring
The type of the SSO to be set. Available values SAML, OIDC.
sso_urlstring
The SSO URL / SAML endpoint / Identity provider Single sign-on URL. Set when type is SAML.
issuerstring
Issuer URI, IDP Entity ID, SSO issuer, provider issuer, AD identifier or the base URL of the OpenID Connect (OIDC) server.
certificatestring
The x509 certificate content. Set when type is SAML.
signature_methodstring
Available values are sha1, sha256, sha512. Set when type is SAML.
digest_methodstring
Available values are sha1, sha256, sha512. Set when type is SAML.
require_sso_for_all_membersboolean
Require SSO authentication.
client_idstring
The client ID of the identity provider application.
client_secretstring
The client secret of the identity provider application.

Last modified on Sep 23, 2024

Example:

CURL
curl -X PATCH "https://api.buddy.worksworkspaces/:domain/sso" \ -H "Authorization: Bearer <YOUR-TOKEN>" \ -H "Content-Type: application/json" \
EXAMPLE RESPONSE
{ "sso_url": "https://login.microsoftonline.com/bbe6af31-7a4f-4c88-b180-ed18ab154b24/saml2", "issuer": "https://sts.windows.net/bcde6af31-7a4f-4c88-b180-ed18ab054b44/", "certificate": "-----BEGIN CERTIFICATE-----\r\nMIIC8DXCAdigAwIBAgIQKk9e1LkXXX/rMC+MrqGciiXILL\r\nxbLtT2E+SdHXgxKMXsq/\r\n-----END CERTIFICATE-----\r\n", "signature_method": "sha256", "digest_method": "sha256", "require_sso_for_all_members": false }
STATUS
200 OK
LIMITS
X-Rate-Limit-Limit: 1 X-Rate-Limit-Remaining: 999