---
title: "Get the user's prioritized task agenda"
method: GET
path: "/api/v1/agenda"
---

# Get the user's prioritized task agenda

`GET /api/v1/agenda`

## Request

- Base URL: `https://myagentda.com`
- URL: `https://myagentda.com/api/v1/agenda`
- Auth: API key in header `Authorization`

Returns the user's prioritized task overview as Markdown: follow-ups due today, overdue tasks, tasks due today, tasks delegated to others (waiting), and remaining open tasks. Snoozed tasks are hidden. Use this whenever the user asks what is on their plate or what they should work on next. Render or summarize the returned Markdown for the user.

## Query parameters

- `scope` 'mine' | 'delegated_by_me' | 'cc'

## Response `200`

The agenda was rendered successfully.

- object: The rendered agenda.
  - `markdown` string: The full agenda as Markdown, grouped into sections such as Overdue, Due today and Open. Empty agendas return a short notice instead.
  - `snoozed_count` integer: Number of snoozed tasks hidden from the agenda.

## Other responses

- `401`: The access token is missing or invalid.

---

[API](https://skmtc.dev/myagentda/apis/agentda.md) · [All operations](https://skmtc.dev/myagentda/apis/agentda/llms.txt) · [OpenAPI document](https://skmtc.dev/myagentda/apis/agentda/revisions/66a449ab49dc?raw)