---
title: "Refresh Metrics"
method: POST
path: "/metrics/refresh"
tags: ["Metrics"]
---

# Refresh Metrics

`POST /metrics/refresh`

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.

## Query parameters

- `db_id` string, nullable — Database ID to use for metrics calculation
- `table` string, nullable — Table to use for metrics calculation

## Response `200`

Metrics refreshed successfully

- DayAggregatedMetrics[]
  - `id` string, required — Unique identifier for the metrics record
  - `agent_runs_count` integer, required — Total number of agent runs
  - `agent_sessions_count` integer, required — Total number of agent sessions
  - `team_runs_count` integer, required — Total number of team runs
  - `team_sessions_count` integer, required — Total number of team sessions
  - `workflow_runs_count` integer, required — Total number of workflow runs
  - `workflow_sessions_count` integer, required — Total number of workflow sessions
  - `users_count` integer, required — Total number of unique users
  - `token_metrics` object, required — Token usage metrics (input, output, cached, etc.)
  - `model_metrics` object[], required — Metrics grouped by model (model_id, provider, count)
  - `date` string, date-time, required — Date for which these metrics are aggregated
  - `created_at` string, date-time, required — Timestamp when metrics were created
  - `updated_at` string, date-time, required — Timestamp when metrics were last updated

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Validation Error
- `500` — Failed to refresh metrics

---

[API](https://skmtc.net/agno/apis/agno-api-reference.md) · [All operations](https://skmtc.net/agno/apis/agno-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agno/agno-api-reference/revisions/5f6149d395d0/schema)