Ask Sage

Ask Sage Superadmin API

Superadmin system operations

GitHub OpenAPI
Business capability
Identity & Access Management BC-620.20

Operations 94

POST /superadmin-get-all-users-with-tokens Get all users with token info (superadmin) #
POST /superadmin-export-users-csv Export all users to CSV (superadmin) #
POST /superadmin-get-users Get users (superadmin) #
POST /superadmin-get-user-count Get total user count (superadmin) #
POST /superadmin-get-stats Get system statistics (superadmin) #
POST /superadmin-get-token-stats Get token usage statistics (superadmin) #
POST /superadmin-get-all-logs Get system logs (superadmin) #
POST /superadmin-update-user-verified Verify user email (superadmin) #
POST /superadmin-update-user-banned Ban/unban user (superadmin) #
POST /superadmin-update-user-paid Update user paid status (superadmin) #
POST /superadmin-update-user-admin Grant/revoke admin privileges (superadmin) #
POST /superadmin-update-user-tokens Update user token limit (superadmin) #
POST /superadmin-update-user-train-tokens Update user training token limit (superadmin) #
POST /superadmin-change-email Change user email (superadmin) #
POST /superadmin-assign-payer Assign payer email to user (superadmin) #
POST /superadmin-deassign-organization Remove user from organization (superadmin) #
POST /superadmin-cuimfa Enable/disable CUI MFA authorization (superadmin) #
POST /superadmin-delete-last-chatsession Delete user's last chat session (superadmin) #
POST /superadmin-reset-mfa Reset user MFA (superadmin) #
POST /superadmin-reset-cac Reset user CAC (superadmin) #
POST /superadmin-reset-pw Reset user password (superadmin) #
POST /superadmin-assign-dataset Assign dataset to user (superadmin) #
POST /superadmin-deassign-dataset Remove dataset from user (superadmin) #
POST /superadmin-get-dataset Get user datasets (superadmin) #
POST /superadmin-delete-all-dataset Delete dataset from all users (superadmin) #
POST /superadmin-assign-persona Assign persona to user (superadmin) #
POST /superadmin-assign-plugin Assign plugin to user (superadmin) #
POST /superadmin-get-user-api-keys Get user API keys (superadmin) #
POST /superadmin-user-api-key Create API key for user (superadmin) #
POST /superadmin-get-all-organizations Get all organizations (superadmin) #
POST /superadmin-add-organization Add new organization (superadmin) #
PUT /superadmin-update-organization/{organization_id} Update organization (superadmin) #
GET /superadmin-get-organization/{organization_id} Get organization details (superadmin) #
POST /superadmin-assign-users-to-organization Assign users to organization (superadmin) #
POST /superadmin-add-organization-purchase Add organization purchase (superadmin) #
PUT /superadmin-update-organization-purchase/{purchase_id} Update organization purchase (superadmin) #
POST /superadmin-get-organization-purchases/{organization_id} Get organization purchases (superadmin) #
POST /superadmin-update-sales Import sales data from Excel (superadmin) #
POST /superadmin-export-weekly-reports Export weekly organization report (superadmin) #
POST /superadmin-export-weekly-model-usage-csv Export model usage report (superadmin) #
POST /superadmin-allocation-policy-get Get allocation policy (superadmin) #
POST /superadmin-allocation-policy-update Update allocation policy (superadmin) #
POST /superadmin-token-distribution-preview Preview token distribution (superadmin) #
POST /superadmin-token-distribution-execute Execute token distribution (superadmin) #
POST /superadmin-allocation-dashboard Get allocation dashboard (superadmin) #
POST /superadmin-get-all-datasets Get all datasets (superadmin) #
POST /superadmin-get-dataset-files Get dataset files (superadmin) #
POST /superadmin-get-dataset-statistics Get dataset statistics (superadmin) #
POST /superadmin-get-dataset-details Get dataset details (superadmin) #
POST /superadmin-export-datasets-csv Export datasets to CSV (superadmin) #
POST /superadmin-get-analytics-data Get analytics data (superadmin) #
POST /superadmin-export-label-usage-csv Export label usage to CSV (superadmin) #
POST /superadmin-get-token-requests Get token requests (superadmin) #
POST /superadmin-review-token-request Review token request (superadmin) #
POST /superadmin-total-purchased-tokens-organization Get total purchased tokens for organization (superadmin) #
POST /superadmin-used-tokens-for-organization Get used tokens for organization (superadmin) #
POST /superadmin-activate-allocation-preset Activate allocation preset (superadmin) #
POST /superadmin-audit-events-export Audit events export (superadmin) #
POST /superadmin-audit-events-list Audit events list (superadmin) #
POST /superadmin-auto-increase-policy-get Auto increase policy get (superadmin) #
POST /superadmin-auto-increase-policy-update Auto increase policy update (superadmin) #
POST /superadmin-delete-user-allocation-override Delete user allocation override (superadmin) #
POST /superadmin-demote-user Demote user (superadmin) #
POST /superadmin-diagnose-duplicate-active-policies Diagnose duplicate active policies (superadmin) #
POST /superadmin-disable-allocation-preset Disable allocation preset (superadmin) #
GET /superadmin-get-model-enablement Get model enablement (superadmin) #
POST /superadmin-get-organization-policies/{org_id} Get organization policies (superadmin) #
GET /superadmin-get-organization-settings/{organization_id} Get organization settings (superadmin) #
POST /superadmin-get-policy-change-history/{org_id} Get policy change history (superadmin) #
POST /superadmin-get-role-change-history/{org_id} Get role change history (superadmin) #
POST /superadmin-list-user-allocation-overrides List user allocation overrides (superadmin) #
POST /superadmin-org-mcp-status/{org_id} Org mcp status (superadmin) #
POST /superadmin-org-token-usage Org token usage (superadmin) #
POST /superadmin-organization-ext-oauth-config/{org_id} Organization ext oauth config (superadmin) #
GET /superadmin-organization-ext-oauth-list/{org_id} Organization ext oauth list (superadmin) #
POST /superadmin-organization-ext-oauth-update/{org_id} Organization ext oauth update (superadmin) #
POST /superadmin-promote-user Promote user (superadmin) #
POST /superadmin-reclamation-preview Reclamation preview (superadmin) #
POST /superadmin-revoke-user-api-key Revoke user api key (superadmin) #
POST /superadmin-seed-model-enablement Seed model enablement (superadmin) #
POST /superadmin-set-model-enablement Set model enablement (superadmin) #
POST /superadmin-set-user-allocation-override Set user allocation override (superadmin) #
POST /superadmin-stats-usage-series Stats usage series (superadmin) #
POST /superadmin-stats-usage-summary Stats usage summary (superadmin) #
POST /superadmin-token-distribution-history Token distribution history (superadmin) #
POST /superadmin-token-distribution-policy-get Token distribution policy get (superadmin) #
POST /superadmin-token-distribution-policy-update Token distribution policy update (superadmin) #
POST /superadmin-token-usage-summary Token usage summary (superadmin) #
POST /superadmin-unpin-user-allocation Unpin user allocation (superadmin) #
PUT /superadmin-update-organization-limit-ips/{organization_id} Update organization limit ips (superadmin) #
POST /superadmin-update-organization-policy/{org_id} Update organization policy (superadmin) #
PUT /superadmin-update-organization-settings/{organization_id} Update organization settings (superadmin) #
POST /superadmin-update-user-status Update user status (superadmin) #
PUT /superadmin-set-cui-authorized-sso/{organization_id} Set CUI authorized SSO (superadmin) #

Documentation

📖
APIReference
https://docs.asksage.ai/api-docs/swagger.html

Specifications

⚙
OpenAPI
https://artifacts.apis.io/ask-sage/openapi/ask-sage-superadmin-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/ask-sage:ask-sage-superadmin-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ask-sage-superadmin-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Ask Sage User API — Full Response Reference Superadmin API
  description: 'Ask Sage User API for account management, organization administration, billing, and platform configuration.


    ## Base URL

    `https://api.asksage.ai/user`


    ## Authentication

    Most endpoints require a valid JWT token sent in the `x-access-tokens` HTTP header. Secured endpoints show a padlock in Swagger UI / Redoc — click **Authorize** and paste your token once to apply it to every request.


    Get a token from `/get-token-with-api-key` (your email + 64-character API key), then send it on each call:


    `x-access-tokens: `


    **No token required:** `/get-token-with-api-key`, `/register`, `/verify-email`, `/lost-pass`, and `GET /get-headers`.


    Beyond a valid token, admin (`admin-*`) and superadmin (`superadmin-*`) endpoints require the caller to hold the matching role, and many identify the target user via an `email` field in the request body.

    ## Key Features

    - **User Management** — Profile updates, API key management, login history

    - **Chat Sessions** — Create, retrieve, and manage conversation history

    - **Dataset Management** — Create datasets, manage permissions and assignments

    - **Workbooks** — Organize research with sources and memos

    - **Organization Admin** — User management, token allocation, usage reporting

    - **Superadmin** — Platform-wide administration and analytics'
  version: '2.0'
  contact:
    name: Support
    email: support@asksage.ai
    url: https://asksage.ai
servers:
- url: '{baseUrl}/user'
  description: Ask Sage User API
  variables:
    baseUrl:
      default: https://api.asksage.ai
      description: API base URL. Use https://api.asksage.ai for production, or your self-hosted instance URL.
security:
- ApiKeyAuth: []
tags:


# --- truncated at 32 KB (202 KB total) ---
# Full source: https://artifacts.apis.io/ask-sage/openapi/ask-sage-superadmin-api-openapi.yml