# Creates a new version of sso configuration for a given authorisation server.

**POST /organisations/{OrganisationId}/authorisationservers/{AuthorisationServerId}/sso-configuration/{ssoConfigurationId}/versions**




## Servers
- Raidiam Directory Sandbox Environment: https://matls-api.sandbox.raidiam.io (Raidiam Directory Sandbox Environment)


## Authentication methods
- O auth


## Parameters
### Headers
- **x-fapi-auth-date** (string)
  The time when the PSU last logged in with the TPP. 
  All dates in the HTTP headers are represented as RFC 7231 Full Dates. An example is below: 
  Sun, 10 Sep 2017 19:43:31 UTC
- **x-fapi-customer-ip-address** (string)
  The PSU's IP address if the PSU is currently logged in with the TPP.
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.
- **x-customer-user-agent** (string)
  Indicates the user-agent that the PSU is using.

### Path parameters
- **OrganisationId** (string)
  The organisation ID
- **AuthorisationServerId** (string(uuid))
  The authorisation server Id
- **ssoConfigurationId** (string(uuid))
  The unique identifier representing a given sso configuration of an authorisation server


### Body: application/json (object)

- **AdditionalScopeValues** (string)
  Additional space-separated scope values that will be requested alongside the default of openid, email and profile
- **AuthenticationPolicies** (array[string])
  List of sign-in policies that are applied during authentication
- **ClientID** (string)
  The Client ID to be used by the Raidiam IDP to retrieve identity claims from the external IDP used for SSO
- **GroupClaim** (string)
  The name of the claim in the ID Token returned by the external IDP containing the list of user group identifiers
- **GroupClaimPath** (string)
  Valid JSON Path indicating the location in the ID Token of the group claim
- **RestrictedDomains** (array[string])
  List of email domains that will be forced to use this IDP for SSO
- **SupportedDomains** (array[string])
  List email domains that will have the option to use this IDP for SSO


## Responses
### 201
A single sso configuration version for a given authorisation server's sso configuration
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

#### Body: application/json (object)
- **AdditionalScopeValues** (string)
  Additional space-separated scope values that will be requested alongside the default of openid, email and profile
- **AuthenticationPolicies** (array[string])
  List of sign-in policies that are applied during authentication
- **ClientID** (string)
  The Client ID to be used by the Raidiam IDP to retrieve identity claims from the external IDP used for SSO
- **GroupClaim** (string)
  The name of the claim in the ID Token returned by the external IDP containing the list of user group identifiers
- **GroupClaimPath** (string)
  Valid JSON Path indicating the location in the ID Token of the group claim
- **RestrictedDomains** (array[string])
  List of email domains that will be forced to use this IDP for SSO
- **SupportedDomains** (array[string])
  List email domains that will have the option to use this IDP for SSO
- **Status** (string)
  The status of a resource that has an approval flow
- **CreatedAt** (string(date-time))

- **ID** (string(uuid))
  Unique identifier of the given OpenID Connect Provider's SSO Configuration
- **SsoConfigurationID** (string(uuid))
  Unique identifier of the given OpenID Connect Provider's SSO Configuration
- **UpdatedAt** (string(date-time))

- **Version** (integer(int16))
  Version number of the SSO configuration

### 400
Bad Request
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

#### Body: application/json (object)
- **errors** (array[string])
  Validation Error messages

### 401
Unauthorized
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 403
Forbidden
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 429
Too many requests, maximum capacity reached. Requests are now throttled.
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 500
Internal Server Error
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 502
Bad Gateway
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 504
Upstream timeout, insufficient capacity to serve request. More capacity being brought online. Please try again.
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.


[Powered by Bump.sh](https://bump.sh)