# Saml API

API Reference for Saml

> **Terminology Update:** We have streamlined our naming conventions to improve clarity. The term **Saml** has been replaced with **Saml**. To avoid breaking changes the APIs still make use of the old term. Both terms refer to the same underlying functionality.

## Device Authorization

### Get Device Authorization Request
Get the device authorization based on the provided 'user code'. This will return the device authorization request, which contains the device authorization id that is required to authorize the request.

[Get Device Authorization Request](/content/docs/reference/api/oidc/zitadel.oidc.v2.OIDCService.GetDeviceAuthorizationRequest)

### Create Response
Finalize a SAML Request and get the response definition for success or failure. The response must be handled as per the SAML definition to inform the application about the success or failure.

[Create Response](/content/docs/reference/api/saml/zitadel.saml.v2.SAMLService.CreateResponse)