Update attachment api documentation

Updates the date of the contribution
Adds missing parameter documentation
Adds example curl requests how to call the API
Use term attachment instead of image to make more generic

Resolves review comment nextcloud#1600 (comment)

Signed-off-by: oli-ver <[email protected]>

Author: oli-ver

docs/api/v1.md

@@ -15,7 +15,7 @@ In this document, the Notes API major version 1 and all its minor versions are d
 |   **1.1**   | Notes 3.4 (May 2020)        | Filter "Get all notes" by category                 |
 |   **1.2**   | Notes 4.1 (June 2021)       | Preventing lost updates, read-only notes, settings |
 |   **1.3**   | Notes 4.5 (August 2022)     | Allow custom file suffixes                         |
-|   **1.4**   | Notes 4.9 (November 2023)   | Add external image api                             |
+|   **1.4**   | Notes 4.9 (August 2025)     | Add external image api                             |
 
 
 
@@ -285,9 +285,17 @@ No valid authentication credentials supplied.
 *(since API v1.4)*
 
 #### Request parameters
-| Parameter | Type                    | Description                        |
-|:----------|:------------------------|:-----------------------------------|
-| `path`    | string, required (path) | Path or name of the image to load. |
+| Parameter | Type                         | Description                                |
+|:----------|:-----------------------------|:-------------------------------------------|
+| `id`      | integer, required (path)     | ID of the note to load the attachment from |
+| `path`    | string, required (request)   | Path or name of the attachment to load.    |
+
+Example:
+
+```bash
+curl -u "user:password" "https://yournextcloud.com/index.php/apps/notes/api/v1.4/attachment/<id>?path=<path>" -o <outputfilename>.jpg
+```
+
 
 #### Response
 ##### 200 OK
@@ -307,7 +315,21 @@ No valid authentication credentials supplied.
 *(since API v1.4)*
 
 #### Request parameters
-None.
+| Parameter | Type                    | Description                                     |
+|:----------|:------------------------|:------------------------------------------------|
+| `id`      | integer, required (path)| ID of the note to upload the attachment to      |
+
+Example:
+
+```bash
+curl -u "user:password" \
+       -X POST \
+       -F "file=@/path/to/image.png" \
+       "https://yournextcloud.com/index.php/apps/notes/api/v1.4/attachment/<id>"
+
+# The post request will return the filename that was generated:
+{"filename":"d8aef2005b4f815fec8ade5388240f2c.png"}
+```
 
 #### Response
 ##### 200 OK