---
title: "Promote To System Admin"
method: POST
path: "/api/v1/admin/system-admins"
tags: ["system-admins"]
---

# Promote To System Admin

`POST /api/v1/admin/system-admins`

## Request

- Base URL: `https://memory.kagura-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://memory.kagura-ai.com/api/v1/admin/system-admins`
- Auth: none declared

Promote a user to system administrator.

Requires: System Admin role

Args:
    request: User ID to promote

Returns:
    Updated user with success message

Raises:
    404: User not found
    400: User is already a system admin

Example request:
    {
      "user_id": "google-oauth2|123456"
    }

Example response:
    {
      "success": true,
      "user": { ... user details ... },
      "message": "User admin2@example.com promoted to system administrator"
    }

## Request body

- PromoteToSystemAdminRequest: Request to promote user to system admin. Issue #166: System Admin promotion.
  - `user_id` string, required: OAuth2 user_id to promote

## Response `200`

Successful Response

- PromoteToSystemAdminResponse: Response for system admin promotion. Issue #166: System Admin promotion result.
  - `success` boolean, required
  - `user` UserWithAdminFlag, required: User model with system admin flags for admin management. Issue #166: System Admin vs Workspace Admin RBAC separation. Issue #1813: no integer ``id`` — address users by ``user_id``.
    - `email` unknown, required
    - `user_id` unknown, required
    - `name` unknown, required
    - `picture` unknown, required
    - `role` unknown, required
    - `is_initial_admin` unknown, required
    - `created_at` unknown, required
    - `last_login_at` unknown, required
    - `memory_count` unknown, required
    - `is_active` unknown, required
  - `message` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud.md) · [All operations](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/revisions/09f17f5ada29?raw)