Agno Metrics API
The Metrics API from Agno — 2 operation(s) for metrics.
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/agno-metrics-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: Agno API Reference A2A Metrics API
description: The all-in-one, private, secure agent platform that runs in your cloud.
version: 2.5.6
servers:
- url: https://api.agno.com
description: Base URL reconciled from apis.yml
tags:
- name: Metrics
paths:
/metrics:
get:
tags:
- Metrics
summary: Get AgentOS Metrics
description: Retrieve AgentOS metrics and analytics data for a specified date range. If no date range is specified, returns all available metrics.
operationId: get_metrics
security:
- HTTPBearer: []
parameters:
- name: starting_date
in: query
required: false
schema:
anyOf:
- type: string
format: date
- type: 'null'
description: Starting date for metrics range (YYYY-MM-DD format)
title: Starting Date
description: Starting date for metrics range (YYYY-MM-DD format)
- name: ending_date
in: query
required: false
schema:
anyOf:
- type: string
format: date
- type: 'null'
description: Ending date for metrics range (YYYY-MM-DD format)
title: Ending Date
description: Ending date for metrics range (YYYY-MM-DD format)
- name: db_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Database ID to query metrics from
title: Db Id
description: Database ID to query metrics from
- name: table
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: The database table to use
title: Table
description: The database table to use
responses:
'200':
description: Metrics retrieved successfully
content:
application/json:
schema:
$ref: '#/components/schemas/MetricsResponse'
example:
metrics:
- id: 7bf39658-a00a-484c-8a28-67fd8a9ddb2a
agent_runs_count: 5
agent_sessions_count: 5
team_runs_count: 0
team_sessions_count: 0
workflow_runs_count: 0
workflow_sessions_count: 0
users_count: 1
token_metrics:
input_tokens: 448
output_tokens: 148
total_tokens: 596
audio_tokens: 0
input_audio_tokens: 0
output_audio_tokens: 0
cached_tokens: 0
cache_write_tokens: 0
reasoning_tokens: 0
model_metrics:
- model_id: gpt-4o
model_provider: OpenAI
count: 5
date: '2025-07-31T00:00:00Z'
created_at: '2025-07-31T12:38:52Z'
updated_at: '2025-07-31T12:49:01Z'
'400':
description: Invalid date range parameters
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthenticatedResponse'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationErrorResponse'
'500':
description: Failed to retrieve metrics
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
/metrics/refresh:
post:
tags:
- Metrics
summary: Refresh Metrics
description: Manually trigger recalculation of system metrics from raw data. This operation analyzes system activity logs and regenerates aggregated metrics. Useful for ensuring metrics are up-to-date or after system maintenance.
operationId: refresh_metrics
security:
- HTTPBearer: []
parameters:
- name: db_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Database ID to use for metrics calculation
title: Db Id
description: Database ID to use for metrics calculation
- name: table
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Table to use for metrics calculation
title: Table
description: Table to use for metrics calculation
responses:
'200':
description: Metrics refreshed successfully
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/DayAggregatedMetrics'
title: Response Refresh Metrics
example:
- id: e77c9531-818b-47a5-99cd-59fed61e5403
agent_runs_count: 2
agent_sessions_count: 2
team_runs_count: 0
team_sessions_count: 0
workflow_runs_count: 0
workflow_sessions_count: 0
users_count: 1
token_metrics:
input_tokens: 256
output_tokens: 441
total_tokens: 697
audio_total_tokens: 0
audio_input_tokens: 0
audio_output_tokens: 0
cache_read_tokens: 0
cache_write_tokens: 0
reasoning_tokens: 0
model_metrics:
- model_id: gpt-4o
model_provider: OpenAI
count: 2
date: '2025-08-12T00:00:00Z'
created_at: '2025-08-12T08:01:47Z'
updated_at: '2025-08-12T08:01:47Z'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthenticatedResponse'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationErrorResponse'
'500':
description: Failed to refresh metrics
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
components:
schemas:
BadRequestResponse:
properties:
detail:
type: string
title: Detail
description: Error detail message
error_code:
anyOf:
- type: string
- type: 'null'
title: Error Code
description: Error code for categorization
type: object
required:
- detail
title: BadRequestResponse
example:
detail: Bad request
error_code: BAD_REQUEST
InternalServerErrorResponse:
properties:
detail:
type: string
title: Detail
description: Error detail message
error_code:
anyOf:
- type: string
- type: 'null'
title: Error Code
description: Error code for categorization
type: object
required:
- detail
title: InternalServerErrorResponse
example:
detail: Internal server error
error_code: INTERNAL_SERVER_ERROR
ValidationErrorResponse:
properties:
detail:
type: string
title: Detail
description: Error detail message
error_code:
anyOf:
- type: string
- type: 'null'
title: Error Code
description: Error code for categorization
type: object
required:
- detail
title: ValidationErrorResponse
example:
detail: Validation error
error_code: VALIDATION_ERROR
DayAggregatedMetrics:
properties:
id:
type: string
title: Id
description: Unique identifier for the metrics record
agent_runs_count:
type: integer
minimum: 0
title: Agent Runs Count
description: Total number of agent runs
agent_sessions_count:
type: integer
minimum: 0
title: Agent Sessions Count
description: Total number of agent sessions
team_runs_count:
type: integer
minimum: 0
title: Team Runs Count
description: Total number of team runs
team_sessions_count:
type: integer
minimum: 0
title: Team Sessions Count
description: Total number of team sessions
workflow_runs_count:
type: integer
minimum: 0
title: Workflow Runs Count
description: Total number of workflow runs
workflow_sessions_count:
type: integer
minimum: 0
title: Workflow Sessions Count
description: Total number of workflow sessions
users_count:
type: integer
minimum: 0
title: Users Count
description: Total number of unique users
token_metrics:
additionalProperties: true
type: object
title: Token Metrics
description: Token usage metrics (input, output, cached, etc.)
model_metrics:
items:
additionalProperties: true
type: object
type: array
title: Model Metrics
description: Metrics grouped by model (model_id, provider, count)
date:
type: string
format: date-time
title: Date
description: Date for which these metrics are aggregated
created_at:
type: string
format: date-time
title: Created At
description: Timestamp when metrics were created
updated_at:
type: string
format: date-time
title: Updated At
description: Timestamp when metrics were last updated
type: object
required:
- id
- agent_runs_count
- agent_sessions_count
- team_runs_count
- team_sessions_count
- workflow_runs_count
- workflow_sessions_count
- users_count
- token_metrics
- model_metrics
- date
- created_at
- updated_at
title: DayAggregatedMetrics
description: Aggregated metrics for a given day
NotFoundResponse:
properties:
detail:
type: string
title: Detail
description: Error detail message
error_code:
anyOf:
- type: string
- type: 'null'
title: Error Code
description: Error code for categorization
type: object
required:
- detail
title: NotFoundResponse
example:
detail: Not found
error_code: NOT_FOUND
MetricsResponse:
properties:
metrics:
items:
$ref: '#/components/schemas/DayAggregatedMetrics'
type: array
title: Metrics
description: List of daily aggregated metrics
updated_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Updated At
description: Timestamp of the most recent metrics update
type: object
required:
- metrics
title: MetricsResponse
UnauthenticatedResponse:
properties:
detail:
type: string
title: Detail
description: Error detail message
error_code:
anyOf:
- type: string
- type: 'null'
title: Error Code
description: Error code for categorization
type: object
required:
- detail
title: UnauthenticatedResponse
example:
detail: Unauthenticated access
error_code: UNAUTHENTICATED
securitySchemes:
HTTPBearer:
type: http
scheme: bearer