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. |