Skip to content

List managed Wordwarden connector instances

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

Lists Wordwarden instances and recent status episodes reported by signed heartbeat messages.

tenantId
required
string
connector_id
string
limit
integer
>= 1 <= 100

Managed connector instances and recent status episodes.

Media type application/json
object
tenantId
required
string
items
required
Array<object>
object
connector_id
required
string
/^wwcon_[a-zA-Z0-9]{16}$/
instance_id
required
string
version
required
string
release_channel
required
string
default: stable
status
required
string
Allowed values: connected disconnected stale version_mismatch unhealthy deactivated
affected_advisory_count
required
integer
advisory_matches
required
Array<object>
object
id
required
string
severity
required
string
Allowed values: low medium high critical
fixed_version
string | null
summary
required
string
release_url
string | null
key
additional properties
key
additional properties
recent_episodes
required
Array<object>
object
id
required
string
tenant_id
required
string
connector_id
required
string
/^wwcon_[a-zA-Z0-9]{16}$/
instance_id
required
string
<= 128 characters
status
required
string
Allowed values: connected disconnected stale version_mismatch unhealthy deactivated
started_at
required
integer
ended_at
integer | null
last_seen_at
required
integer
reason

Operational reason classification. Secret values and raw signatures are not exposed.

string | null
acknowledged_at
integer | null
acknowledged_by
string | null
created_at
required
integer
updated_at
required
integer
key
additional properties
key
additional properties
Example
{
"items": [
{
"release_channel": "stable",
"status": "connected",
"advisory_matches": [
{
"severity": "low"
}
]
}
],
"recent_episodes": [
{
"status": "connected"
}
]
}

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"
}

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"
}

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"
}