Admin Overview

GET /v1/admin/dashboard

{
  "total_users": 1200,
  "active_users_30d": 380,
  "total_runs": 45000,
  "runs_today": 230,
  "total_input_tokens": 150000000,
  "total_output_tokens": 75000000,
  "total_cost_usd": 450.00,
  "active_orgs": 85
}

GET /v1/admin/users

[
  {
    "id": "...",
    "login": "alice",
    "username": "Alice",
    "email": "alice@example.com",
    "status": "active",
    "avatar_url": null,
    "locale": "zh-CN",
    "timezone": "Asia/Shanghai",
    "last_login_at": "2024-01-15T10:00:00Z",
    "created_at": "2024-01-01T00:00:00Z"
  }
]

GET /v1/admin/users/{user_id}

PATCH /v1/admin/users/{user_id}

DELETE /v1/admin/users/{user_id}

GET /v1/admin/runs/{run_id}

{
  "run_id": "...",
  "org_id": "...",
  "thread_id": "...",
  "status": "completed",
  "model": "claude-3-5-sonnet-20241022",
  "persona_id": null,
  "provider_kind": "anthropic",
  "credential_name": "Main Anthropic Account",
  "persona_model": "anthropic-main^claude-sonnet-4-20250514",
  "duration_ms": 3200,
  "total_input_tokens": 1000,
  "total_output_tokens": 500,
  "total_cost_usd": 0.005,
  "created_at": "2024-01-01T00:00:00Z",
  "completed_at": "2024-01-01T00:00:03Z"
}

GET /v1/admin/email/status

{
  "configured": true,
  "from": "noreply@example.com",
  "source": "db"
}

GET /v1/admin/email/config

{
  "from": "noreply@example.com",
  "smtp_host": "smtp.example.com",
  "smtp_port": 587,
  "smtp_user": "noreply@example.com",
  "smtp_pass_set": true,
  "smtp_tls_mode": "starttls"
}

PUT /v1/admin/email/config

POST /v1/admin/email/test

GET /v1/admin/gateway-config

{
  "ip_mode": "proxy",
  "trusted_cidrs": ["10.0.0.0/8"],
  "risk_reject_threshold": 0.8
}

PUT /v1/admin/gateway-config

GET /v1/admin/access-log

{
  "data": [
    {
      "id": "...",
      "timestamp": "2024-01-01T00:00:00Z",
      "trace_id": "...",
      "method": "POST",
      "path": "/v1/threads",
      "status_code": 201,
      "duration_ms": 45,
      "client_ip": "1.2.3.4",
      "country": "CN",
      "city": "Beijing",
      "user_agent": "Mozilla/5.0...",
      "ua_type": "browser",
      "risk_score": 0.1,
      "identity_type": "user",
      "org_id": "...",
      "user_id": "...",
      "username": "alice"
    }
  ],
  "has_more": true,
  "next_before": "..."
}

GET /v1/admin/invite-codes

[
  {
    "id": "...",
    "user_id": "...",
    "code": "ABC123",
    "max_uses": 10,
    "use_count": 3,
    "is_active": true,
    "created_at": "...",
    "user_login": "alice",
    "user_email": "alice@example.com"
  }
]

GET /v1/admin/invite-codes/{id}

PATCH /v1/admin/invite-codes/{id}

GET /v1/admin/referrals

GET /v1/admin/referrals/tree?user_id={user_id}

[
  {
    "user_id": "...",
    "login": "alice",
    "inviter_id": null,
    "depth": 0,
    "created_at": "..."
  }
]

POST /v1/admin/redemption-codes/batch

GET /v1/admin/redemption-codes

PATCH /v1/admin/redemption-codes/{id}