Admin API

22 endpoints. All require admin permission on the calling principal.

Tenant configuration#

Method	Path	Purpose
`GET`	`/v1/admin/ai-config`	Tenant's default AI settings.
`PUT`	`/v1/admin/ai-config`	Update.
`GET`	`/v1/admin/stats`	Tenant statistics: rooms, participants, AI usage, storage.
`GET`	`/v1/admin/audit`	Audit log (paginated).
`GET`	`/v1/admin/prompt-studio`	Prompt-studio feature flag state.
`PUT`	`/v1/admin/prompt-studio`	Toggle feature + manage allowlist.
`GET`	`/v1/admin/note-processing`	Note-organisation AI config.
`PUT`	`/v1/admin/note-processing`	Update.

PUT /v1/admin/ai-config#

json
{
  "default_model": "claude-sonnet-4-6",
  "enabled_models": ["claude-sonnet-4-6", "scailar-pro"],
  "system_prompt_templates": [
    { "name": "Friendly", "prompt": "You are a friendly assistant." }
  ],
  "scaigrid_auth_mode": "per_user_exchange",
  "scaigrid_api_key": null
}

Models (catalog)#

Method	Path	Purpose
`GET`	`/v1/admin/models/catalog`	All models from ScaiGrid, with enabled state.
`POST`	`/v1/admin/models/{slug:path}/enable`	Enable for the tenant.
`POST`	`/v1/admin/models/{slug:path}/disable`	Disable.
`PUT`	`/v1/admin/models/{slug:path}/participant`	Configure / re-configure the AI participant for a model.

The slug is the ScaiGrid model slug (mistralai/voxtral-small-latest).

PUT .../participant body#

json
{
  "local_id": "code-helper",
  "display_name": "Code Helper",
  "system_prompt": "You are a code review assistant. Prefer brevity.",
  "default_response_mode": "conversational",
  "enabled": true
}

Plugins#

Method	Path	Purpose
`GET`	`/v1/admin/plugins`	List with per-tenant state.
`POST`	`/v1/admin/plugins/{plugin_id}/enable`	Enable.
`POST`	`/v1/admin/plugins/{plugin_id}/disable`	Disable.

Participants#

Method	Path	Purpose
`GET`	`/v1/admin/participants`	All participants in the tenant.
`POST`	`/v1/admin/participants/model`	Create a new model participant manually.

(For helper config, see Helpers and skills.)

Tenants and partners#

Method	Path	Purpose
`POST`	`/v1/admin/tenants`	Create a tenant (partner-admin only).
`GET`	`/v1/admin/partners`	List partners.
`POST`	`/v1/admin/partners`	Create.
`GET`	`/v1/admin/partners/{partner_id}`	Detail.
`PUT`	`/v1/admin/partners/{partner_id}`	Update.

Partner-admin endpoints require partner_admin role and operate across the partner's tenant fleet.

Audit#

GET /v1/admin/audit returns:

json
{
  "data": [
    {
      "id": "audit-…",
      "tenant_id": "abc-…",
      "actor_id": "5e4d…",
      "actor_type": "user",
      "action": "room.close",
      "resource_type": "room",
      "resource_id": "room-…",
      "metadata": { "reason": "..." },
      "ip": "10.0.0.1",
      "user_agent": "...",
      "created_at": "..."
    }
  ]
}

Filterable by action, actor_id, resource_type, resource_id, since, until, limit.