Skip to main content
POST
/
organizations
/
{id}
/
enterprise-connections
/
test
Test enterprise connection config
curl --request POST \
  --url https://api.wacht.dev/organizations/{id}/enterprise-connections/test \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --cookie session_id= \
  --data protocol=saml \
  --data 'idp_entity_id=<string>' \
  --data 'idp_sso_url=<string>' \
  --data 'idp_certificate=<string>' \
  --data 'oidc_issuer_url=<string>' \
  --data 'oidc_client_id=<string>' \
  --data 'oidc_client_secret=<string>'
{
  "success": true,
  "protocol": "saml",
  "checks": {
    "certificate_valid": true,
    "idp_reachable": true,
    "configuration_valid": true
  },
  "errors": null
}

Authorizations

session_id
string
cookie
required

Session-based authentication using cookies

Path Parameters

id
string<uint64>
required

Organization ID

Body

application/x-www-form-urlencoded
protocol
enum<string>
required
Available options:
saml,
oidc
Example:

"saml"

idp_entity_id
string
idp_sso_url
string<uri>
idp_certificate
string
oidc_issuer_url
string<uri>
oidc_client_id
string
oidc_client_secret
string

Response

Connection test results

success
boolean

Overall test success

Example:

true

protocol
enum<string>

Protocol being tested

Available options:
saml,
oidc
Example:

"saml"

checks
object

Individual check results

Example:
{
"certificate_valid": true,
"idp_reachable": true,
"configuration_valid": true
}
errors
object

Error messages per check

Example:

null