---
title: "Update the SAML Authentication settings for this Organization."
method: PATCH
path: "/orgs/{org}/saml-authentication"
tags: ["orgs"]
---

# Update the SAML Authentication settings for this Organization.

`PATCH /orgs/{org}/saml-authentication`

Update the SAML Authentication settings for this Organization.

## Request body

- OrganizationSAMLAuthRequestPatch
  - `saml_auth_enabled` boolean
  - `saml_auth_enforced` boolean
  - `saml_metadata_inline` string — If configured, SAML metadata will be used as entered instead of retrieved from a remote URL.
  - `saml_metadata_inline_webapp` string, nullable — When configured, this inline SAML metadata is used instead of the legacy app SAML configuration when signing into the new Cloudsmith web application.
  - `saml_metadata_url` string, uri, nullable — If configured, SAML metadata be retrieved from a remote URL.
  - `saml_metadata_url_webapp` string, uri, nullable — When configured, this SAML metadata URL is used instead of the legacy app SAML configuration when signing into the new Cloudsmith web application.

## Response `200`

Updated the SAML Authentication settings.

- OrganizationSAMLAuth
  - `saml_auth_enabled` boolean, required
  - `saml_auth_enforced` boolean, required
  - `saml_metadata_inline` string — If configured, SAML metadata will be used as entered instead of retrieved from a remote URL.
  - `saml_metadata_inline_webapp` string, nullable — When configured, this inline SAML metadata is used instead of the legacy app SAML configuration when signing into the new Cloudsmith web application.
  - `saml_metadata_url` string, uri, nullable — If configured, SAML metadata be retrieved from a remote URL.
  - `saml_metadata_url_webapp` string, uri, nullable — When configured, this SAML metadata URL is used instead of the legacy app SAML configuration when signing into the new Cloudsmith web application.

## Other responses

- `400` — Request could not be processed (see detail).
- `402` — SAML Authentication is not available; please upgrade your account!
- `404` — Organization not found.
- `422` — Missing or invalid parameters (see detail).

---

[API](https://skmtc.dev/cloudsmith/apis/cloudsmith-api-v1.md) · [All operations](https://skmtc.dev/cloudsmith/apis/cloudsmith-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudsmith/cloudsmith-api-v1/revisions/4d7879df9b2f/schema)