Unisson superadmin API
The superadmin API from Unisson — 3 operation(s) for superadmin.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/unisson-superadmin-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Unisson agent-evals Superadmin API
version: 1.0.0
servers:
- url: https://api.unisson.ai
description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: superadmin
paths:
/api/v1/superadmin/check:
get:
tags:
- superadmin
summary: Check Superadmin
description: Check if the current organization has superadmin access.
operationId: check_superadmin_api_v1_superadmin_check_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security:
- HTTPBearer: []
/api/v1/superadmin/costs:
get:
tags:
- superadmin
summary: Get Costs
description: Get cost data across all organizations (superadmin only).
operationId: get_costs_api_v1_superadmin_costs_get
security:
- HTTPBearer: []
parameters:
- name: granularity
in: query
required: false
schema:
type: string
pattern: ^(daily|weekly|monthly)$
default: daily
title: Granularity
- name: start_date
in: query
required: false
schema:
anyOf:
- type: string
format: date
- type: 'null'
description: Start date YYYY-MM-DD
title: Start Date
description: Start date YYYY-MM-DD
- name: end_date
in: query
required: false
schema:
anyOf:
- type: string
format: date
- type: 'null'
description: End date YYYY-MM-DD
title: End Date
description: End date YYYY-MM-DD
- name: org_id
in: query
required: false
schema:
anyOf:
- type: string
format: uuid
- type: 'null'
description: Filter to a specific org
title: Org Id
description: Filter to a specific org
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SuperadminCostsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/superadmin/error-analytics:
get:
tags:
- superadmin
summary: Get Error Analytics
description: Get error analytics across all organizations (superadmin only).
operationId: get_error_analytics_api_v1_superadmin_error_analytics_get
security:
- HTTPBearer: []
parameters:
- name: granularity
in: query
required: false
schema:
type: string
pattern: ^(daily|weekly|monthly)$
default: daily
title: Granularity
- name: start_date
in: query
required: false
schema:
anyOf:
- type: string
format: date
- type: 'null'
description: Start date YYYY-MM-DD
title: Start Date
description: Start date YYYY-MM-DD
- name: end_date
in: query
required: false
schema:
anyOf:
- type: string
format: date
- type: 'null'
description: End date YYYY-MM-DD
title: End Date
description: End date YYYY-MM-DD
- name: org_id
in: query
required: false
schema:
anyOf:
- type: string
format: uuid
- type: 'null'
description: Filter to a specific org
title: Org Id
description: Filter to a specific org
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorAnalyticsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ConfiguredModel:
properties:
role:
type: string
title: Role
model:
type: string
title: Model
used_by:
type: string
title: Used By
type: object
required:
- role
- model
- used_by
title: ConfiguredModel
description: 'Which model a product surface is *configured* to run on (from
settings.*_MODEL) — the intent view, independent of the date filter.'
SuperadminCostsResponse:
properties:
org_summaries:
items:
$ref: '#/components/schemas/OrgCostSummary'
type: array
title: Org Summaries
time_series:
items:
$ref: '#/components/schemas/TimeBucket'
type: array
title: Time Series
grand_total_cost:
type: number
title: Grand Total Cost
grand_total_llm_cost:
type: number
title: Grand Total Llm Cost
grand_total_kernel_cost:
type: number
title: Grand Total Kernel Cost
grand_total_runs:
type: integer
title: Grand Total Runs
kernel_cost_per_second:
type: number
title: Kernel Cost Per Second
cost_by_category:
items:
$ref: '#/components/schemas/CategoryCost'
type: array
title: Cost By Category
cost_by_model:
items:
$ref: '#/components/schemas/ModelCost'
type: array
title: Cost By Model
category_time_series:
items:
$ref: '#/components/schemas/CategoryTimeBucket'
type: array
title: Category Time Series
category_model_breakdown:
items:
$ref: '#/components/schemas/CategoryModelCost'
type: array
title: Category Model Breakdown
configured_models:
items:
$ref: '#/components/schemas/ConfiguredModel'
type: array
title: Configured Models
type: object
required:
- org_summaries
- time_series
- grand_total_cost
- grand_total_llm_cost
- grand_total_kernel_cost
- grand_total_runs
- kernel_cost_per_second
- cost_by_category
- cost_by_model
- category_time_series
- category_model_breakdown
- configured_models
title: SuperadminCostsResponse
CategoryModelCost:
properties:
category:
type: string
title: Category
model:
type: string
title: Model
cost:
type: number
title: Cost
input_tokens:
type: integer
title: Input Tokens
output_tokens:
type: integer
title: Output Tokens
call_count:
type: integer
title: Call Count
type: object
required:
- category
- model
- cost
- input_tokens
- output_tokens
- call_count
title: CategoryModelCost
description: 'A (category, model) pair with its real spend — the join between the
cost-by-category and cost-by-model breakdowns.'
TimeBucket:
properties:
period:
type: string
title: Period
org_id:
type: string
title: Org Id
org_name:
type: string
title: Org Name
llm_cost:
type: number
title: Llm Cost
kernel_cost:
type: number
title: Kernel Cost
total_cost:
type: number
title: Total Cost
run_count:
type: integer
title: Run Count
type: object
required:
- period
- org_id
- org_name
- llm_cost
- kernel_cost
- total_cost
- run_count
title: TimeBucket
CategoryCost:
properties:
category:
type: string
title: Category
cost:
type: number
title: Cost
input_tokens:
type: integer
title: Input Tokens
output_tokens:
type: integer
title: Output Tokens
type: object
required:
- category
- cost
- input_tokens
- output_tokens
title: CategoryCost
CategoryTimeBucket:
properties:
period:
type: string
title: Period
category:
type: string
title: Category
cost:
type: number
title: Cost
call_count:
type: integer
title: Call Count
type: object
required:
- period
- category
- cost
- call_count
title: CategoryTimeBucket
ErrorAnalyticsResponse:
properties:
total_failed_runs:
type: integer
title: Total Failed Runs
total_runs:
type: integer
title: Total Runs
failure_rate:
type: number
title: Failure Rate
error_by_category:
items:
$ref: '#/components/schemas/ErrorCategoryCount'
type: array
title: Error By Category
error_by_org:
items:
$ref: '#/components/schemas/OrgErrorSummary'
type: array
title: Error By Org
error_time_series:
items:
$ref: '#/components/schemas/ErrorTimeBucket'
type: array
title: Error Time Series
type: object
required:
- total_failed_runs
- total_runs
- failure_rate
- error_by_category
- error_by_org
- error_time_series
title: ErrorAnalyticsResponse
OrgCostSummary:
properties:
org_id:
type: string
title: Org Id
org_name:
type: string
title: Org Name
total_runs:
type: integer
title: Total Runs
total_duration_seconds:
type: integer
title: Total Duration Seconds
total_llm_cost:
type: number
title: Total Llm Cost
total_kernel_cost:
type: number
title: Total Kernel Cost
total_cost:
type: number
title: Total Cost
total_llm_tokens:
type: integer
title: Total Llm Tokens
type: object
required:
- org_id
- org_name
- total_runs
- total_duration_seconds
- total_llm_cost
- total_kernel_cost
- total_cost
- total_llm_tokens
title: OrgCostSummary
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
ErrorCategoryCount:
properties:
category:
type: string
title: Category
count:
type: integer
title: Count
percentage:
type: number
title: Percentage
type: object
required:
- category
- count
- percentage
title: ErrorCategoryCount
ModelCost:
properties:
model:
type: string
title: Model
cost:
type: number
title: Cost
input_tokens:
type: integer
title: Input Tokens
output_tokens:
type: integer
title: Output Tokens
call_count:
type: integer
title: Call Count
type: object
required:
- model
- cost
- input_tokens
- output_tokens
- call_count
title: ModelCost
OrgErrorSummary:
properties:
org_id:
type: string
title: Org Id
org_name:
type: string
title: Org Name
total_failed:
type: integer
title: Total Failed
error_breakdown:
items:
$ref: '#/components/schemas/ErrorCategoryCount'
type: array
title: Error Breakdown
type: object
required:
- org_id
- org_name
- total_failed
- error_breakdown
title: OrgErrorSummary
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ErrorTimeBucket:
properties:
period:
type: string
title: Period
category:
type: string
title: Category
count:
type: integer
title: Count
type: object
required:
- period
- category
- count
title: ErrorTimeBucket
securitySchemes:
HTTPBearer:
type: http
scheme: bearer