diff --git a/docs/core/entity/todo.md b/docs/core/entity/todo.md
index 2c4ba389..8ec79f32 100644
--- a/docs/core/entity/todo.md
+++ b/docs/core/entity/todo.md
@@ -83,7 +83,7 @@ class MyTodoListEntity(TodoListEntity):
 
 A To-do list entity may support re-ordering To-do items in the list by specifying
 the `MOVE_TODO_ITEM` supported feature. The To-do item with the specified `uid`
-should be moved to the position in the list specified by `pos` (`0` is the first
+should be moved to the position in the list after the one specified by `previous_uid` (`None` means move to the first
 position in the To-do list).
 
 ```python
@@ -91,7 +91,11 @@ from homeassistant.components.todo import TodoListEntity
 
 class MyTodoListEntity(TodoListEntity):
 
-    async def async_move_todo_item(self, uid: str, pos: int) -> None:
+    async def async_move_todo_item(
+        self,
+        uid: str,
+        previous_uid: str | None = None
+    ) -> None:
         """Move an item in the To-do list."""
 ```