---
title: "Suggest next tasks from the caller's recent work"
method: GET
path: "/api/me/task-suggestions"
---

# Suggest next tasks from the caller's recent work

`GET /api/me/task-suggestions`

## Request

- Base URL: `https://www.toma.com`
- URL: `https://www.toma.com/api/me/task-suggestions`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `better-auth.session_token`

Returns up to three new, related task ideas from the caller's ten most recent tasks. Suggestions go beyond previous deliverables rather than copying their titles. No task history returns an empty list. This does not create or publish a task. Limited to 30 requests per member per hour across REST and MCP.

## Response `200`

Optional next-task ideas.

- object
  - `suggestions` string[], required

## Other responses

- `401`: No valid session or API key.
- `403`: The caller's email is not verified yet.
- `429`: Too many suggestion requests; Retry-After gives the wait in seconds.
- `503`: Task suggestions are temporarily unavailable.

---

[API](https://skmtc.dev/toma/apis/toma-api.md) - [All operations](https://skmtc.dev/toma/apis/toma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toma/apis/toma-api/revisions/b4e56e1db5a2?raw)