# Deep Security Manager REST API

## Path: / rest / identity-providers / saml / {samlIdentityProviderID}

Describe a SAML identity provider.

Path parameters:
  samlIdentityProviderID - the SAML identity provider ID.

Method Summary
Resource | Description
--- | ---
`GET /rest/identity-providers/saml/{samlIdentityProviderID}` | Describe a SAML identity provider.
`POST /rest/identity-providers/saml/{samlIdentityProviderID}` | Modify a SAML identity provider.
`DELETE /rest/identity-providers/saml/{samlIdentityProviderID}` | Delete a SAML identity provider.

Method Detail
Describe a SAML identity provider. Output: `DescribeSAMLIdentityProviderResponse` - a {@link DescribeSAMLIdentityProviderResponse} with the SAML identity provider details. Cookie parameters: sID - a session ID returned by the Authentication API. Produces: application/json Consumes: application/json HTTP return codes: 200 - if the request is successful 403 - if the user is not authorized to view SAML identity providers 404 - if the user is authorized to view SAML identity providers but the SAML identity provider does not exist
Modify a SAML identity provider. Any unset elements in the request object will be left unchanged by the modify request. Input: `ModifySAMLIdentityProviderRequest` - a {@link ModifySAMLIdentityProviderRequest} with the details of the SAML identity provider. Output: `ModifySAMLIdentityProviderResponse` - an {@link ModifySAMLIdentityProviderResponse} with the updated SAMLIdentityProvider details. Cookie parameters: sID - a session ID returned by the Authentication API. Produces: application/json Consumes: application/json HTTP return codes: 200 - if the request is successful 400 - if the requested change is invalid 403 - if the user is not authorized to modify SAML identity providers or if the requested modification is not permitted 404 - if the user is authorized to modify SAML identity providers but the SAML identity provider does not exist
Delete a SAML identity provider. Output: `void` Cookie parameters: sID - a session ID returned by the Authentication API. Produces: application/json Consumes: application/json HTTP return codes: 200 - if the request is successful 403 - if the user is not authorized to delete SAML identity providers

Copyright © 2017 Trend Micro Inc. All Rights Reserved.