---
title: "The caller's chats that wait on them, in every project"
method: GET
path: "/agents/needs-you"
tags: ["AI", "Agents"]
---

# The caller's chats that wait on them, in every project

`GET /agents/needs-you`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/agents/needs-you`
- 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`

The Agent icon's dot and the briefing's Needs you list: each own chat in `workspace_id` whose last reply waits on its owner (a plan to run, a question, a failure, a run at its limit) and that they have not dismissed, failures first then newest; and `new_results`, the chats with a result they have not seen. Opening a chat does not clear a to-do; resolving or dismissing it does.

## Query parameters

- `workspace_id` integer, required

## Response `200`

Request fulfilled, document follows

- AgentNeedsYouResponse
  - `items` AgentNeedItem[], required
    - `session_id` string, required
    - `title` string, nullable
    - `project_id` integer, nullable
    - `kind` 'plan' | 'approval' | 'question' | 'failed' | 'capped', required
    - `action` 'run' | 'review' | 'answer' | 'retry' | 'open', required
    - `since` string, nullable
    - `key` string, required
    - `plan_id` string, nullable
    - `goal` string, nullable
  - `new_results` string[], required

## 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/5dfd1c296ded?raw)