---
title: "Show TUI toast"
method: POST
path: "/tui/show-toast"
---

# Show TUI toast

`POST /tui/show-toast`

Show a toast notification in the TUI

## Query parameters

- `directory` string
- `workspace` string

## Request body

- object
  - `title` string
  - `message` string, required
  - `variant` 'info' | 'success' | 'warning' | 'error', required
  - `duration` number — Duration in milliseconds

## Response `200`

Toast notification shown successfully

- boolean

## Changes

- **2026-05-06** `067d03067fb2` — 1 info
  - the `duration` request property default value `5000` was removed
- **2026-04-25** `0a2d50cb4204` — 1 info
  - added the new optional `query` request parameter `workspace`
- **2025-12-16** `dc065d96c390` — 1 warning, 1 info
  - deleted the `query` request parameter `directory`
  - added the new optional request property `duration`
- **2025-10-15** `323dc6f9a248` — 1 warning, 1 info
  - deleted the `query` request parameter `directory`
  - added the new optional `query` request parameter `directory`

[Change history](https://skmtc.dev/kaaass/apis/opencode/changes/tui/show-toast/post.md)

---

[API](https://skmtc.dev/kaaass/apis/opencode.md) · [All operations](https://skmtc.dev/kaaass/apis/opencode/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kaaass/opencode/revisions/8bb9a15bd144/schema)