Skip to content
Authrim

List directory connector relay events

GET
/api/admin/tenants/{tenantId}/directory-connectors/{connectorId}/events
Code sample: Shell / cURL 
curl --request GET \
  --url https://auth.example.com/api/admin/tenants/example/directory-connectors/example/events \
  --header 'Authorization: Bearer <token>'

Returns a bounded recent event list for an outbound relay connector.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
tenantId
required
string
connectorId
required
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Recent directory connector relay events.

Media type application/json
object
ok
required
boolean
connector_id
required
string
status
integer
body
One of:
object
tenant_id
required
string
connector_id
required
string
events
required
Array<object>
<= 100 items
object
id
required
string format: uuid
timestamp
required
string format: date-time
tenantId
required
string
connectorId
required
string
type
required
string
Allowed values: directory_relay.connection.challenge_issued directory_relay.connection.rejected directory_relay.connection.authenticated directory_relay.connection.closed directory_relay.overloaded directory_relay.verify.forwarded directory_relay.verify.succeeded directory_relay.verify.failed directory_relay.verify.timeout
requestId
string
keyId
string
code
string
result
string
retryable
boolean
key
additional properties
key
additional properties
error
string
error_description
string
key
additional properties
Example 
{
  "ok": true,
  "connector_id": "campus",
  "status": 200,
  "body": {
    "tenant_id": "tenant_123",
    "connector_id": "wwcon_8K4M2Q9F7D3H6P1X",
    "events": [
      {
        "id": "9b8d7d7d-3c2f-4c8f-a5d1-bac67a81f4a1",
        "timestamp": "2026-06-23T12:00:00.000Z",
        "tenantId": "tenant_123",
        "connectorId": "wwcon_8K4M2Q9F7D3H6P1X",
        "type": "directory_relay.verify.failed",
        "requestId": "req_123",
        "code": "relay_verify_timeout",
        "retryable": true
      }
    ]
  }
}

400

Section titled “400 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Section titled “401 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Section titled “403 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

404

Section titled “404 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

502

Section titled “502 ”

Recent directory connector relay events.

Media type application/json
object
ok
required
boolean
connector_id
required
string
status
integer
body
One of:
object
tenant_id
required
string
connector_id
required
string
events
required
Array<object>
<= 100 items
object
id
required
string format: uuid
timestamp
required
string format: date-time
tenantId
required
string
connectorId
required
string
type
required
string
Allowed values: directory_relay.connection.challenge_issued directory_relay.connection.rejected directory_relay.connection.authenticated directory_relay.connection.closed directory_relay.overloaded directory_relay.verify.forwarded directory_relay.verify.succeeded directory_relay.verify.failed directory_relay.verify.timeout
requestId
string
keyId
string
code
string
result
string
retryable
boolean
key
additional properties
key
additional properties
error
string
error_description
string
key
additional properties
Example 
{
  "ok": true,
  "connector_id": "campus",
  "status": 200,
  "body": {
    "tenant_id": "tenant_123",
    "connector_id": "wwcon_8K4M2Q9F7D3H6P1X",
    "events": [
      {
        "id": "9b8d7d7d-3c2f-4c8f-a5d1-bac67a81f4a1",
        "timestamp": "2026-06-23T12:00:00.000Z",
        "tenantId": "tenant_123",
        "connectorId": "wwcon_8K4M2Q9F7D3H6P1X",
        "type": "directory_relay.verify.failed",
        "requestId": "req_123",
        "code": "relay_verify_timeout",
        "retryable": true
      }
    ]
  }
}

503

Section titled “503 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}