---
title: "POST /update-auth-method-saml"
method: POST
path: "/update-auth-method-saml"
tags: ["Authentication"]
---

# POST /update-auth-method-saml

`POST /update-auth-method-saml`

## Request

- Base URL: `https://api.akeyless.io`
- URL: `https://api.akeyless.io/update-auth-method-saml`
- Auth: none declared

## Request body

- UpdateAuthMethodSAML: updateAuthMethodSAML is a command that updates a new auth method that will be available to authenticate using SAML. [Deprecated: Use auth-method-update-saml command]
  - `access-expires` integer: Access expiration date in Unix timestamp (select 0 for access without expiry date)
  - `allowed-client-type` string[]: limit the auth method usage for specific client types [cli,ui,gateway-admin,sdk,mobile,extension]
  - `allowed-redirect-uri` string[]: Allowed redirect URIs after the authentication
  - `audit-logs-claims` string[]: Subclaims to include in audit logs, e.g "--audit-logs-claims email --audit-logs-claims username"
  - `bound-ips` string[]: A CIDR whitelist with the IPs that the access is restricted to
  - `delete_protection` string: Protection from accidental deletion of this object [true/false]
  - `description` string: Auth Method description
  - `expiration-event-in` string[]: How many days before the expiration of the auth method would you like to be notified.
  - `force-sub-claims` boolean: if true: enforce role-association must include sub claims
  - `gateway-url` string: Akeyless Gateway URL (Configuration Management port). Relevant only when working with Gateway mode
  - `gw-bound-ips` string[]: A CIDR whitelist with the GW IPs that the access is restricted to
  - `idp-metadata-url` string: IDP metadata url
  - `idp-metadata-xml-data` string: IDP metadata xml data
  - `json` boolean: Set output format to JSON
  - `jwt-ttl` integer: Jwt TTL
  - `name` string, required: Auth Method name
  - `new-name` string: Auth Method new name
  - `product-type` string[]: Choose the relevant product type for the auth method [sm, sra, pm, dp, ca, ara]
  - `subclaims-delimiters` string[]: A list of additional sub claims delimiters (relevant only for SAML, OIDC, OAuth2/JWT)
  - `token` string: Authentication token (see `/auth` and `/configure`)
  - `uid-token` string: The universal identity token, Required only for universal_identity authentication
  - `unique-identifier` string, required: A unique identifier (ID) value should be configured for OAuth2, LDAP and SAML authentication method types and is usually a value such as the email, username, or upn for example. Whenever a user logs in with a token, these authentication types issue a "sub claim" that contains details uniquely identifying that user. This sub claim includes a key containing the ID value that you configured, and is used to distinguish between different users from within the same organization.
  - `use-dedicated-saml-urls` boolean: Use dedicated per-access-id SP URLs for login

## Response `200`

updateAuthMethodSAMLResponse wraps response body.

- UpdateAuthMethodSAMLOutput

## Other responses

- `default`: errorResponse wraps any error to return it as a JSON object with one "error" field.

---

[API](https://skmtc.dev/akeyless/apis/identity-access.md) - [All operations](https://skmtc.dev/akeyless/apis/identity-access/llms.txt) - [OpenAPI document](https://skmtc.dev/akeyless/apis/identity-access/revisions/6fbc3858ec88?raw)