docs: Document limitations of the API

Author: claremacrae

docs/Advanced/Tasks Api.md

@@ -164,3 +164,10 @@ This can be used, for example, to display the Auto-Suggest on non-task lines. [S
 > [!warning]
 > If the `Editor` is not a `MarkdownView`, the functionality is slightly limited.
 > It won't be possible to create [[Task Dependencies]] fields `id` and `dependsOn`.
+
+## Limitations of the Tasks API
+
+- Editing tasks:
+  - It is not yet possible to use the API to edit an *existing task line* with Tasks [[Create or edit Task|Create or edit task UI]]. We are tracking this in [issue #1945](https://github.com/obsidian-tasks-group/obsidian-tasks/issues/1945).
+- Searching tasks:
+  - It is not yet possible to run Tasks searches via the API. We are tracking this in [issue #2459](https://github.com/obsidian-tasks-group/obsidian-tasks/issues/2459).

docs/Support and Help/Known Limitations.md

@@ -106,3 +106,7 @@ This page gathers together all the documentation on known limitations of the plu
 ## Advanced: Urgency
 
 ![[Urgency#Limitations of the Urgency Score]]
+
+## Advanced: Tasks API
+
+![[Tasks Api#Limitations of the Tasks API]]