From 1feb183a8794d5e6e31b4b0203dff091991536ae Mon Sep 17 00:00:00 2001
From: david-fraley <67079030+david-fraley@users.noreply.github.com>
Date: Fri, 17 Apr 2026 15:17:37 -0500
Subject: [PATCH] docs: remove unused `paused` and `completed` chat statuses,
 add `requires_action` (#24264)

---
 docs/ai-coder/agents/chats-api.md | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/docs/ai-coder/agents/chats-api.md b/docs/ai-coder/agents/chats-api.md
index 64be4812d7..2d6c9f664a 100644
--- a/docs/ai-coder/agents/chats-api.md
+++ b/docs/ai-coder/agents/chats-api.md
@@ -324,11 +324,10 @@ appear in the `files` field on subsequent
 
 ## Chat statuses
 
-| Status      | Meaning                                                      |
-|-------------|--------------------------------------------------------------|
-| `waiting`   | Idle — newly created, finished successfully, or interrupted. |
-| `pending`   | Queued for processing.                                       |
-| `running`   | Agent is actively working.                                   |
-| `paused`    | Agent is paused (e.g. waiting for user input).               |
-| `completed` | Agent finished and the task is complete.                     |
-| `error`     | Agent encountered an error.                                  |
+| Status            | Meaning                                                                      |
+|-------------------|------------------------------------------------------------------------------|
+| `waiting`         | No pending work (newly created, finished, or interrupted).                   |
+| `pending`         | Queued for processing.                                                       |
+| `running`         | Agent is actively working.                                                   |
+| `error`           | Agent encountered an error.                                                  |
+| `requires_action` | Agent invoked a client-provided tool and needs the result before continuing. |