Skip to content

Admin

Operations Summary

Method Endpoint Description
GET /api/admin/matrix-appservice/status/ Get Matrix appservice status
GET /api/admin/matrix/diagnostics/ Run Matrix connectivity diagnostics
GET /api/admin/matrix/livekit/overview/ Get LiveKit calls overview
GET /api/admin/matrix/livekit/participants/ List participants in a LiveKit room
POST /api/admin/matrix-appservice/setup/ Setup Matrix appservice registration
POST /api/admin/matrix/reprovision/ Reprovision all active Matrix rooms on a new homeserver

Get Matrix appservice status

Returns the current appservice configuration state.

1
2
3
4
http \
  GET \
  https://api.example.com/api/admin/matrix-appservice/status/ \
  Authorization:"Token YOUR_API_TOKEN"

1
2
3
4
5
6
7
8
9
from waldur_api_client.client import AuthenticatedClient
from waldur_api_client.api.admin import admin_matrix_appservice_status_retrieve # (1)

client = AuthenticatedClient(
    base_url="https://api.example.com", token="YOUR_API_TOKEN"
)
response = admin_matrix_appservice_status_retrieve.sync(client=client)

print(response)
  1. API Source: admin_matrix_appservice_status_retrieve
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
import { adminMatrixAppserviceStatusRetrieve } from 'waldur-js-client';

try {
  const response = await adminMatrixAppserviceStatusRetrieve({
  auth: "Token YOUR_API_TOKEN"
});
  console.log('Success:', response);
} catch (error) {
  console.error('Error:', error);
}

200 -

Field Type
enabled boolean
as_token_configured boolean
hs_token_configured boolean
sender_localpart string
bot_user_id string
webhook_path string
homeserver_url string
homeserver_domain string
transaction_count integer

Run Matrix connectivity diagnostics

Performs live connectivity checks against the configured Matrix homeserver and returns results for each check.

1
2
3
4
http \
  GET \
  https://api.example.com/api/admin/matrix/diagnostics/ \
  Authorization:"Token YOUR_API_TOKEN"

1
2
3
4
5
6
7
8
9
from waldur_api_client.client import AuthenticatedClient
from waldur_api_client.api.admin import admin_matrix_diagnostics_retrieve # (1)

client = AuthenticatedClient(
    base_url="https://api.example.com", token="YOUR_API_TOKEN"
)
response = admin_matrix_diagnostics_retrieve.sync(client=client)

print(response)
  1. API Source: admin_matrix_diagnostics_retrieve
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
import { adminMatrixDiagnosticsRetrieve } from 'waldur-js-client';

try {
  const response = await adminMatrixDiagnosticsRetrieve({
  auth: "Token YOUR_API_TOKEN"
});
  console.log('Success:', response);
} catch (error) {
  console.error('Error:', error);
}

200 -

Field Type
ok boolean
checks array of objects
checks.name string
checks.label string
checks.ok boolean
checks.detail string

Get LiveKit calls overview

Point-in-time snapshot of active LiveKit rooms with participant/publisher totals. Staff only. Returns 503 when LiveKit credentials are not configured and 502 when LiveKit is unreachable or rejects the configured credentials.

1
2
3
4
http \
  GET \
  https://api.example.com/api/admin/matrix/livekit/overview/ \
  Authorization:"Token YOUR_API_TOKEN"

1
2
3
4
5
6
7
8
9
from waldur_api_client.client import AuthenticatedClient
from waldur_api_client.api.admin import admin_matrix_livekit_overview_retrieve # (1)

client = AuthenticatedClient(
    base_url="https://api.example.com", token="YOUR_API_TOKEN"
)
response = admin_matrix_livekit_overview_retrieve.sync(client=client)

print(response)
  1. API Source: admin_matrix_livekit_overview_retrieve
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
import { adminMatrixLivekitOverviewRetrieve } from 'waldur-js-client';

try {
  const response = await adminMatrixLivekitOverviewRetrieve({
  auth: "Token YOUR_API_TOKEN"
});
  console.log('Success:', response);
} catch (error) {
  console.error('Error:', error);
}

200 -

Field Type
rooms array of objects
rooms.sid string
rooms.name string
rooms.num_participants integer
rooms.num_publishers integer
rooms.creation_time integer
rooms.max_participants integer
rooms.metadata string
totals object
totals.room_count integer
totals.participant_count integer
totals.publisher_count integer
livekit_url string

List participants in a LiveKit room

Participants and their tracks for a single LiveKit room. Staff only. An unknown or empty room returns 200 with an empty list. Returns 503 when LiveKit credentials are not configured and 502 when LiveKit is unreachable or rejects the configured credentials.

1
2
3
4
5
http \
  GET \
  https://api.example.com/api/admin/matrix/livekit/participants/ \
  Authorization:"Token YOUR_API_TOKEN" \
  room=="string-value"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
from waldur_api_client.client import AuthenticatedClient
from waldur_api_client.api.admin import admin_matrix_livekit_participants_list # (1)

client = AuthenticatedClient(
    base_url="https://api.example.com", token="YOUR_API_TOKEN"
)
response = admin_matrix_livekit_participants_list.sync(
    client=client,
    room="string-value"
)

for item in response:
    print(item)
  1. API Source: admin_matrix_livekit_participants_list
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
import { adminMatrixLivekitParticipantsList } from 'waldur-js-client';

try {
  const response = await adminMatrixLivekitParticipantsList({
  auth: "Token YOUR_API_TOKEN",
  query: {
    "room": "string-value"
  }
});
  console.log('Success:', response);
} catch (error) {
  console.error('Error:', error);
}
Name Type Required Description
room string ✓ LiveKit room name. A query parameter rather than a path segment because Element Call room names are base64 and routinely contain '/'.

200 -

The response body is an array of objects, where each object has the following structure:

Field Type
sid string
identity string
state string
is_publisher boolean
joined_at integer
tracks array of objects
tracks.sid string
tracks.name string
tracks.type string
tracks.muted boolean
tracks.width integer
tracks.height integer

Setup Matrix appservice registration

Generates fresh appservice tokens (rotating any existing ones), enables the appservice, and returns registration YAML.

1
2
3
4
http \
  POST \
  https://api.example.com/api/admin/matrix-appservice/setup/ \
  Authorization:"Token YOUR_API_TOKEN"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
from waldur_api_client.client import AuthenticatedClient
from waldur_api_client.models.matrix_appservice_setup_request import MatrixAppserviceSetupRequest # (1)
from waldur_api_client.api.admin import admin_matrix_appservice_setup # (2)

client = AuthenticatedClient(
    base_url="https://api.example.com", token="YOUR_API_TOKEN"
)

body_data = MatrixAppserviceSetupRequest()
response = admin_matrix_appservice_setup.sync(
    client=client,
    body=body_data
)

print(response)
  1. Model Source: MatrixAppserviceSetupRequest
  2. API Source: admin_matrix_appservice_setup
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
import { adminMatrixAppserviceSetup } from 'waldur-js-client';

try {
  const response = await adminMatrixAppserviceSetup({
  auth: "Token YOUR_API_TOKEN"
});
  console.log('Success:', response);
} catch (error) {
  console.error('Error:', error);
}
Field Type Required Description
url string Waldur URL reachable by the Matrix homeserver (for webhook callbacks)
sender_localpart string Localpart for the appservice bot user, e.g. 'waldur-bot'
homeserver_url string (uri) Matrix homeserver base URL. Only persisted if MATRIX_HOMESERVER_URL is not already configured.
homeserver_public_url string (uri) Optional. Matrix homeserver URL used by browser clients. Leave blank when the homeserver URL above is reachable from both servers and browsers. Set this for deployments where the two differ (e.g. Docker-internal vs. Caddy-proxied). Only persisted if MATRIX_HOMESERVER_PUBLIC_URL is not already configured.
homeserver_domain string Matrix homeserver server_name domain. Only persisted if MATRIX_HOMESERVER_DOMAIN is not already configured.
user_registration_secret string Shared secret configured in the homeserver for user registration. Only persisted if MATRIX_USER_REGISTRATION_SECRET is not already configured.
Constraints: write-only

200 -

Field Type
registration_yaml string
as_token string
hs_token string
sender_localpart string
webhook_url string
bot_provision_status string

Reprovision all active Matrix rooms on a new homeserver

Resets all active rooms to 'creating' state and re-queues them for provisioning. Also resets all user profiles. Staff only.

1
2
3
4
http \
  POST \
  https://api.example.com/api/admin/matrix/reprovision/ \
  Authorization:"Token YOUR_API_TOKEN"

1
2
3
4
5
6
7
8
9
from waldur_api_client.client import AuthenticatedClient
from waldur_api_client.api.admin import admin_matrix_reprovision # (1)

client = AuthenticatedClient(
    base_url="https://api.example.com", token="YOUR_API_TOKEN"
)
response = admin_matrix_reprovision.sync(client=client)

print(response)
  1. API Source: admin_matrix_reprovision
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
import { adminMatrixReprovision } from 'waldur-js-client';

try {
  const response = await adminMatrixReprovision({
  auth: "Token YOUR_API_TOKEN"
});
  console.log('Success:', response);
} catch (error) {
  console.error('Error:', error);
}

202 -

Field Type
rooms_reprovisioned integer
users_reset integer