---
title: "Update Brain Dump Suggested Tasks"
method: POST
path: "/api/onboarding/brain-dump/suggested-tasks"
tags: ["v1", "onboarding", "brain-dump"]
---

# Update Brain Dump Suggested Tasks

`POST /api/onboarding/brain-dump/suggested-tasks`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

Mark suggested tasks sent, dismissed, or open again (Undo).

Takes several ids so "Hide all" and its Undo are one write each.

## Request body

- SuggestedTasksUpdate
  - `task_ids` string[], required
  - `state` 'open' | 'sent' | 'dismissed', required
  - `session_id` string, nullable

## Response `200`

Successful Response

- SuggestedTasksResponse: The user's suggested first tasks, every state included. ``stored`` is false when the user has no list of their own and these are the generic starters: the greeting shows them, the regular Home page does not, until a state change stores them.
  - `tasks` SuggestedTask[]
    - `title` string, required
    - `prompt` string, required
    - `icon` string
    - `id` string, required
    - `state` 'open' | 'sent' | 'dismissed'
    - `session_id` string, nullable
    - `updated_at` string, date-time, nullable
  - `stored` boolean

## Other responses

- `401`: Authentication required
- `422`: Validation Error

## Changes

- **2026-10-21** `c6db349e3eea`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/onboarding/brain-dump/suggested-tasks/post.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) - [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) - [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/c508818c16ad?raw)