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>'
{
  "status": 200,
  "message": "",
  "data": {
    "success": true,
    "protocol": "saml",
    "checks": {
      "certificate_valid": true,
      "idp_reachable": true,
      "configuration_valid": true
    },
    "errors": null
  },
  "session": {
    "id": "123456789012345678",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "errors": [
    {
      "code": "INVALID_CREDENTIALS",
      "message": "Invalid credentials. Please try again."
    }
  ]
}

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

status
integer

HTTP status code

Example:

200

message
string

Response message (empty on success)

Example:

""

data
object
session
object

Minimal session info included in every response

errors
object[] | null

Error details (null on success)