Stytch - Auth platform for developers

The Update SAML Connection method wraps the Update SAML Connection API endpoint. The organization_id will be automatically inferred from the logged-in Member's session. This method cannot be used to update SAML connections in other Organizations.

Authenticated Method

This method requires valid Session for a Member with permission to perform the update Action on the stytch.sso Resource.

Before using this method, enable Member actions & organization modifications in the Frontend SDK page. To learn more, see our RBAC guide.

Method parameters

connection_id* string

Globally unique UUID that identifies a specific SSO connection_id for a Member.

metadata_url* string

A URL that points to the IdP metadata. This will be provided by the IdP.

Response fields

request_id string

Globally unique UUID that is returned with every API call. This value is important to log for debugging purposes; we may ask for this value to help identify a specific API call when helping you debug an issue.

status_code int

The HTTP status code of the response. Stytch follows standard HTTP response status code patterns, e.g. 2XX values equate to success, 3XX values are redirects, 4XX are client errors, and 5XX are server errors.

connection object

The SAML Connection object affected by this API call. See the SAML Connection Object for complete response field details.

import { useStytchB2BClient } from '@stytch/react/b2b'; export const UpdateSAMLConnection = () => { const stytch = useStytchB2BClient(); const updateSAMLConnection = () => { stytch.sso.saml.updateConnectionByURL({ connection_id: 'saml-connection-test-51861cbc-d3b9-428b-9761-227f5fb12be9', metadata_url: 'https://idp.example.com/app/51861cbc-d3b9-428b-9761-227f5fb12be9/sso/saml/metadata', }); }; return <button onClick={updateSAMLConnection}>Update SAML Connection</button>; };

{ "connection": { "acs_url": "https://test.stytch.com/v1/b2b/sso/callback/saml-connection-test-51861cbc-d3b9-428b-9761-227f5fb12be9", "alternative_acs_url": "", "attribute_mapping": { "email": "email", "full_name": "name" }, "audience_uri": "https://test.stytch.com/v1/b2b/sso/callback/saml-connection-test-51861cbc-d3b9-428b-9761-227f5fb12be9", "connection_id": "saml-connection-test-51861cbc-d3b9-428b-9761-227f5fb12be9", "display_name": "Example SAML Connection", "idp_entity_id": "https://idp.example.com/51861cbc-d3b9-428b-9761-227f5fb12be9", "idp_sso_url": "https://idp.example.com/51861cbc-d3b9-428b-9761-227f5fb12be9/sso/saml", "nameid_format": "urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress", "organization_id": "organization-test-07971b06-ac8b-4cdb-9c15-63b17e653931", "signing_certificates": [ { "certificate": "-----BEGIN CERTIFICATE-----\n...base64 blob...\n-----END CERTIFICATE", "created_at": "2023-01-01T00:00:00Z", "expires_at": "2033-01-01T00:00:00Z", "id": "", "issuer": "Stytch" } ], "identity_provider": "generic", "status": "active", "verification_certificates": [ { "certificate": "-----BEGIN CERTIFICATE-----\n...base64 blob...\n-----END CERTIFICATE", "created_at": "2023-01-01T00:00:00Z", "expires_at": "2033-01-01T00:00:00Z", "id": "saml-verification-key-test-5ccbc642-9373-42b8-928f-c1646c868701", "issuer": "" } ], "idp_initiated_auth_disabled": false }, "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141", "status_code": 200 }

{ "status_code": 401, "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141", "error_type": "unauthorized_credentials", "error_message": "Unauthorized credentials.", "error_url": "https://stytch.com/docs/api/errors/401" }

{ "status_code": 403, "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141", "error_type": "session_authorization_error", "error_message": "The Member is not authorized to perform the requested action on that resource.", "error_url": "https://stytch.com/docs/api/errors/403" }

{ "status_code": 429, "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141", "error_type": "too_many_requests", "error_message": "Too many requests have been made.", "error_url": "https://stytch.com/docs/api/errors/429" }

{ "status_code": 500, "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141", "error_type": "internal_server_error", "error_message": "Oops, something seems to have gone wrong, please reach out to support@stytch.com to let us know what went wrong.", "error_url": "https://stytch.com/docs/api/errors/500" }

Discovery

One-Time Passcodes

Time-Based One-Time Passcodes

Recovery Codes

Consent Management

Update SAML Connection by Metadata URL

Method parameters

Response fields