---
title: "What changed in the user's data since their last visit to the agent home"
method: GET
path: "/agents/briefing"
tags: ["AI", "Agents"]
---

# What changed in the user's data since their last visit to the agent home

`GET /agents/briefing`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/agents/briefing`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

Facts for the agent home's briefing (failed exports, datasets updated since `since` with the rows they hold, dashboards built or edited since, alerts that fired since, the biggest data gap), each kind capped; the frontend words them. `since` defaults to a day ago and goes back 30 days at most; `project_id` limits the facts to one project.

## Query parameters

- `workspace_id` integer, required
- `since` string, date-time, nullable
- `project_id` integer, nullable

## Response `200`

Request fulfilled, document follows

- AgentBriefingResponse
  - `facts` BriefingFact[], required
    - `kind` 'export_failed' | 'data_changed' | 'data_gap' | 'board_built' | 'alert_fired', required
    - `object` BriefingObject, required
      - `kind` string, required
      - `id` integer, required
      - `name` string, required
      - `project_id` integer, nullable
      - `view_id` integer, nullable
    - `count` integer, nullable
    - `rows` integer, nullable
    - `detail` string, nullable
    - `at` string, date-time, nullable
    - `total_rows` integer, nullable

## Other responses

- `400`: Bad request syntax or unsupported method
- `403`: Request forbidden -- authorization will not help

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/fe078afe239b?raw)