curl --request POST \
--url https://api.arize.com/v2/saml-identity-providers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email_domains": [
"example.com"
],
"metadata_xml": "<EntityDescriptor xmlns=\"urn:oasis:names:tc:SAML:2.0:metadata\" entityID=\"https://login.example.com\"><IDPSSODescriptor protocolSupportEnumeration=\"urn:oasis:names:tc:SAML:2.0:protocol\"><SingleSignOnService Binding=\"urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect\" Location=\"https://login.example.com/sso\"/></IDPSSODescriptor></EntityDescriptor>",
"enforce_saml": false,
"sync_user_roles": true,
"sign_authn": true,
"allow_login_with_defaults": false,
"role_mappings": [
{
"attributes": {
"groups": "admins"
},
"is_account_admin": true,
"organization": null,
"space_roles": []
}
]
}
'import requests
url = "https://api.arize.com/v2/saml-identity-providers"
payload = {
"email_domains": ["example.com"],
"metadata_xml": "<EntityDescriptor xmlns=\"urn:oasis:names:tc:SAML:2.0:metadata\" entityID=\"https://login.example.com\"><IDPSSODescriptor protocolSupportEnumeration=\"urn:oasis:names:tc:SAML:2.0:protocol\"><SingleSignOnService Binding=\"urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect\" Location=\"https://login.example.com/sso\"/></IDPSSODescriptor></EntityDescriptor>",
"enforce_saml": False,
"sync_user_roles": True,
"sign_authn": True,
"allow_login_with_defaults": False,
"role_mappings": [
{
"attributes": { "groups": "admins" },
"is_account_admin": True,
"organization": None,
"space_roles": []
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
email_domains: ['example.com'],
metadata_xml: '<EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" entityID="https://login.example.com"><IDPSSODescriptor protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol"><SingleSignOnService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect" Location="https://login.example.com/sso"/></IDPSSODescriptor></EntityDescriptor>',
enforce_saml: false,
sync_user_roles: true,
sign_authn: true,
allow_login_with_defaults: false,
role_mappings: [
{
attributes: {groups: 'admins'},
is_account_admin: true,
organization: null,
space_roles: []
}
]
})
};
fetch('https://api.arize.com/v2/saml-identity-providers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.arize.com/v2/saml-identity-providers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'email_domains' => [
'example.com'
],
'metadata_xml' => '<EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" entityID="https://login.example.com"><IDPSSODescriptor protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol"><SingleSignOnService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect" Location="https://login.example.com/sso"/></IDPSSODescriptor></EntityDescriptor>',
'enforce_saml' => false,
'sync_user_roles' => true,
'sign_authn' => true,
'allow_login_with_defaults' => false,
'role_mappings' => [
[
'attributes' => [
'groups' => 'admins'
],
'is_account_admin' => true,
'organization' => null,
'space_roles' => [
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.arize.com/v2/saml-identity-providers"
payload := strings.NewReader("{\n \"email_domains\": [\n \"example.com\"\n ],\n \"metadata_xml\": \"<EntityDescriptor xmlns=\\\"urn:oasis:names:tc:SAML:2.0:metadata\\\" entityID=\\\"https://login.example.com\\\"><IDPSSODescriptor protocolSupportEnumeration=\\\"urn:oasis:names:tc:SAML:2.0:protocol\\\"><SingleSignOnService Binding=\\\"urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect\\\" Location=\\\"https://login.example.com/sso\\\"/></IDPSSODescriptor></EntityDescriptor>\",\n \"enforce_saml\": false,\n \"sync_user_roles\": true,\n \"sign_authn\": true,\n \"allow_login_with_defaults\": false,\n \"role_mappings\": [\n {\n \"attributes\": {\n \"groups\": \"admins\"\n },\n \"is_account_admin\": true,\n \"organization\": null,\n \"space_roles\": []\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.arize.com/v2/saml-identity-providers")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"email_domains\": [\n \"example.com\"\n ],\n \"metadata_xml\": \"<EntityDescriptor xmlns=\\\"urn:oasis:names:tc:SAML:2.0:metadata\\\" entityID=\\\"https://login.example.com\\\"><IDPSSODescriptor protocolSupportEnumeration=\\\"urn:oasis:names:tc:SAML:2.0:protocol\\\"><SingleSignOnService Binding=\\\"urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect\\\" Location=\\\"https://login.example.com/sso\\\"/></IDPSSODescriptor></EntityDescriptor>\",\n \"enforce_saml\": false,\n \"sync_user_roles\": true,\n \"sign_authn\": true,\n \"allow_login_with_defaults\": false,\n \"role_mappings\": [\n {\n \"attributes\": {\n \"groups\": \"admins\"\n },\n \"is_account_admin\": true,\n \"organization\": null,\n \"space_roles\": []\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.arize.com/v2/saml-identity-providers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email_domains\": [\n \"example.com\"\n ],\n \"metadata_xml\": \"<EntityDescriptor xmlns=\\\"urn:oasis:names:tc:SAML:2.0:metadata\\\" entityID=\\\"https://login.example.com\\\"><IDPSSODescriptor protocolSupportEnumeration=\\\"urn:oasis:names:tc:SAML:2.0:protocol\\\"><SingleSignOnService Binding=\\\"urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect\\\" Location=\\\"https://login.example.com/sso\\\"/></IDPSSODescriptor></EntityDescriptor>\",\n \"enforce_saml\": false,\n \"sync_user_roles\": true,\n \"sign_authn\": true,\n \"allow_login_with_defaults\": false,\n \"role_mappings\": [\n {\n \"attributes\": {\n \"groups\": \"admins\"\n },\n \"is_account_admin\": true,\n \"organization\": null,\n \"space_roles\": []\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"email_domains": [
"example.com"
],
"metadata_xml": "<EntityDescriptor xmlns=\"urn:oasis:names:tc:SAML:2.0:metadata\" entityID=\"https://login.example.com\"><IDPSSODescriptor protocolSupportEnumeration=\"urn:oasis:names:tc:SAML:2.0:protocol\"><SingleSignOnService Binding=\"urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect\" Location=\"https://login.example.com/sso\"/></IDPSSODescriptor></EntityDescriptor>",
"enforce_saml": false,
"sync_user_roles": true,
"sign_authn": true,
"allow_login_with_defaults": false,
"role_mappings": [
{
"id": "4fb901ac-5281-4bfb-99f5-848c4d66a95c",
"attributes": {
"groups": "admins"
},
"is_account_admin": true,
"organization": null,
"space_roles": [],
"project_roles": null
}
],
"id": "example.com",
"metadata_url": null,
"default_organization_id": null,
"default_space_id": null,
"default_organization_role_id": null,
"default_space_role_id": null,
"is_managed_by_file": false,
"created_at": "2026-10-12T00:00:00Z",
"updated_at": "2026-10-12T00:00:00Z",
"domain_verification": [
{
"domain": "example.com",
"validated": false
}
]
}{
"status": 400,
"title": "Invalid request parameters",
"detail": "The 'name' field is required and must be a non-empty string.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#invalid-request"
}{
"status": 401,
"title": "Authentication required",
"detail": "You must be authenticated to access this resource.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#authentication-required"
}{
"status": 403,
"title": "Access forbidden",
"detail": "You do not have permission to access this resource.",
"instance": "/resource/12345",
"type": "https://arize.com/docs/ax/rest-reference/errors#access-forbidden"
}{
"status": 404,
"title": "Resource not found",
"detail": "The requested resource with ID '12345' was not found.",
"instance": "/resource/12345",
"type": "https://arize.com/docs/ax/rest-reference/errors#resource-not-found"
}{
"status": 409,
"title": "Resource conflict",
"detail": "A resource with the given identifier already exists.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#resource-conflict"
}{
"status": 422,
"title": "Unprocessable Entity",
"detail": "One or more fields failed validation.",
"instance": "/resource/12345",
"type": "https://arize.com/docs/ax/rest-reference/errors#unprocessable-entity"
}{
"status": 429,
"title": "Rate limit exceeded",
"detail": "You have exceeded the allowed number of requests. Please try again later.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#rate-limit-exceeded"
}Create a SAML identity provider
Warning: This API is alpha and can change without notice. Requires Enterprise account-admin access. Requests use the authenticated callerās account. File-managed configurations are read-only. Default login requires all four default fields. With default login disabled, supply initial role mappings and omit defaults. Domain verification flags are not accepted. Invalid metadata or an unreachable metadata URL returns 400.
curl --request POST \
--url https://api.arize.com/v2/saml-identity-providers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email_domains": [
"example.com"
],
"metadata_xml": "<EntityDescriptor xmlns=\"urn:oasis:names:tc:SAML:2.0:metadata\" entityID=\"https://login.example.com\"><IDPSSODescriptor protocolSupportEnumeration=\"urn:oasis:names:tc:SAML:2.0:protocol\"><SingleSignOnService Binding=\"urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect\" Location=\"https://login.example.com/sso\"/></IDPSSODescriptor></EntityDescriptor>",
"enforce_saml": false,
"sync_user_roles": true,
"sign_authn": true,
"allow_login_with_defaults": false,
"role_mappings": [
{
"attributes": {
"groups": "admins"
},
"is_account_admin": true,
"organization": null,
"space_roles": []
}
]
}
'import requests
url = "https://api.arize.com/v2/saml-identity-providers"
payload = {
"email_domains": ["example.com"],
"metadata_xml": "<EntityDescriptor xmlns=\"urn:oasis:names:tc:SAML:2.0:metadata\" entityID=\"https://login.example.com\"><IDPSSODescriptor protocolSupportEnumeration=\"urn:oasis:names:tc:SAML:2.0:protocol\"><SingleSignOnService Binding=\"urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect\" Location=\"https://login.example.com/sso\"/></IDPSSODescriptor></EntityDescriptor>",
"enforce_saml": False,
"sync_user_roles": True,
"sign_authn": True,
"allow_login_with_defaults": False,
"role_mappings": [
{
"attributes": { "groups": "admins" },
"is_account_admin": True,
"organization": None,
"space_roles": []
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
email_domains: ['example.com'],
metadata_xml: '<EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" entityID="https://login.example.com"><IDPSSODescriptor protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol"><SingleSignOnService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect" Location="https://login.example.com/sso"/></IDPSSODescriptor></EntityDescriptor>',
enforce_saml: false,
sync_user_roles: true,
sign_authn: true,
allow_login_with_defaults: false,
role_mappings: [
{
attributes: {groups: 'admins'},
is_account_admin: true,
organization: null,
space_roles: []
}
]
})
};
fetch('https://api.arize.com/v2/saml-identity-providers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.arize.com/v2/saml-identity-providers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'email_domains' => [
'example.com'
],
'metadata_xml' => '<EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" entityID="https://login.example.com"><IDPSSODescriptor protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol"><SingleSignOnService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect" Location="https://login.example.com/sso"/></IDPSSODescriptor></EntityDescriptor>',
'enforce_saml' => false,
'sync_user_roles' => true,
'sign_authn' => true,
'allow_login_with_defaults' => false,
'role_mappings' => [
[
'attributes' => [
'groups' => 'admins'
],
'is_account_admin' => true,
'organization' => null,
'space_roles' => [
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.arize.com/v2/saml-identity-providers"
payload := strings.NewReader("{\n \"email_domains\": [\n \"example.com\"\n ],\n \"metadata_xml\": \"<EntityDescriptor xmlns=\\\"urn:oasis:names:tc:SAML:2.0:metadata\\\" entityID=\\\"https://login.example.com\\\"><IDPSSODescriptor protocolSupportEnumeration=\\\"urn:oasis:names:tc:SAML:2.0:protocol\\\"><SingleSignOnService Binding=\\\"urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect\\\" Location=\\\"https://login.example.com/sso\\\"/></IDPSSODescriptor></EntityDescriptor>\",\n \"enforce_saml\": false,\n \"sync_user_roles\": true,\n \"sign_authn\": true,\n \"allow_login_with_defaults\": false,\n \"role_mappings\": [\n {\n \"attributes\": {\n \"groups\": \"admins\"\n },\n \"is_account_admin\": true,\n \"organization\": null,\n \"space_roles\": []\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.arize.com/v2/saml-identity-providers")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"email_domains\": [\n \"example.com\"\n ],\n \"metadata_xml\": \"<EntityDescriptor xmlns=\\\"urn:oasis:names:tc:SAML:2.0:metadata\\\" entityID=\\\"https://login.example.com\\\"><IDPSSODescriptor protocolSupportEnumeration=\\\"urn:oasis:names:tc:SAML:2.0:protocol\\\"><SingleSignOnService Binding=\\\"urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect\\\" Location=\\\"https://login.example.com/sso\\\"/></IDPSSODescriptor></EntityDescriptor>\",\n \"enforce_saml\": false,\n \"sync_user_roles\": true,\n \"sign_authn\": true,\n \"allow_login_with_defaults\": false,\n \"role_mappings\": [\n {\n \"attributes\": {\n \"groups\": \"admins\"\n },\n \"is_account_admin\": true,\n \"organization\": null,\n \"space_roles\": []\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.arize.com/v2/saml-identity-providers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email_domains\": [\n \"example.com\"\n ],\n \"metadata_xml\": \"<EntityDescriptor xmlns=\\\"urn:oasis:names:tc:SAML:2.0:metadata\\\" entityID=\\\"https://login.example.com\\\"><IDPSSODescriptor protocolSupportEnumeration=\\\"urn:oasis:names:tc:SAML:2.0:protocol\\\"><SingleSignOnService Binding=\\\"urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect\\\" Location=\\\"https://login.example.com/sso\\\"/></IDPSSODescriptor></EntityDescriptor>\",\n \"enforce_saml\": false,\n \"sync_user_roles\": true,\n \"sign_authn\": true,\n \"allow_login_with_defaults\": false,\n \"role_mappings\": [\n {\n \"attributes\": {\n \"groups\": \"admins\"\n },\n \"is_account_admin\": true,\n \"organization\": null,\n \"space_roles\": []\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"email_domains": [
"example.com"
],
"metadata_xml": "<EntityDescriptor xmlns=\"urn:oasis:names:tc:SAML:2.0:metadata\" entityID=\"https://login.example.com\"><IDPSSODescriptor protocolSupportEnumeration=\"urn:oasis:names:tc:SAML:2.0:protocol\"><SingleSignOnService Binding=\"urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect\" Location=\"https://login.example.com/sso\"/></IDPSSODescriptor></EntityDescriptor>",
"enforce_saml": false,
"sync_user_roles": true,
"sign_authn": true,
"allow_login_with_defaults": false,
"role_mappings": [
{
"id": "4fb901ac-5281-4bfb-99f5-848c4d66a95c",
"attributes": {
"groups": "admins"
},
"is_account_admin": true,
"organization": null,
"space_roles": [],
"project_roles": null
}
],
"id": "example.com",
"metadata_url": null,
"default_organization_id": null,
"default_space_id": null,
"default_organization_role_id": null,
"default_space_role_id": null,
"is_managed_by_file": false,
"created_at": "2026-10-12T00:00:00Z",
"updated_at": "2026-10-12T00:00:00Z",
"domain_verification": [
{
"domain": "example.com",
"validated": false
}
]
}{
"status": 400,
"title": "Invalid request parameters",
"detail": "The 'name' field is required and must be a non-empty string.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#invalid-request"
}{
"status": 401,
"title": "Authentication required",
"detail": "You must be authenticated to access this resource.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#authentication-required"
}{
"status": 403,
"title": "Access forbidden",
"detail": "You do not have permission to access this resource.",
"instance": "/resource/12345",
"type": "https://arize.com/docs/ax/rest-reference/errors#access-forbidden"
}{
"status": 404,
"title": "Resource not found",
"detail": "The requested resource with ID '12345' was not found.",
"instance": "/resource/12345",
"type": "https://arize.com/docs/ax/rest-reference/errors#resource-not-found"
}{
"status": 409,
"title": "Resource conflict",
"detail": "A resource with the given identifier already exists.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#resource-conflict"
}{
"status": 422,
"title": "Unprocessable Entity",
"detail": "One or more fields failed validation.",
"instance": "/resource/12345",
"type": "https://arize.com/docs/ax/rest-reference/errors#unprocessable-entity"
}{
"status": 429,
"title": "Rate limit exceeded",
"detail": "You have exceeded the allowed number of requests. Please try again later.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#rate-limit-exceeded"
}Authorizations
Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format
Service accounts may instead present an access token issued by an external identity provider (Microsoft Entra ID) when the account admin has configured that provider. Send it in the same header: Authorization: Bearer <access-token>.
Body
Supply exactly one metadata source: metadata_url or metadata_xml. Supplying both or neither returns 422.
Response
Successful response.
Was this page helpful?