Updated README.md and API docs to match changes and additions

Author: unkn0wnAPI

README.md

@@ -323,7 +323,7 @@ For user and calendar management there is an API endpoint. See [the API document
 
 > [!TIP]
 >
-> The API endpoint requires an environment variable `API_KEY` set to a secret key that you will use in the `X-API-Key` header of your requests to authenticate. You can generate it with `bin/console api:generate`
+> The API endpoint requires an environment variable `API_KEY` set to a secret key that you will use in the `X-Davis-API-Token` header of your requests to authenticate. You can generate it with `bin/console api:generate`
 
 ## Webserver Configuration Examples
 

docs/api/README.md

@@ -1,28 +1,32 @@
 # Davis API
 
-## Open Endpoints
+## API Version 1
+
+### Open Endpoints
 
 Open endpoints require no Authentication.
 
-* [Health](health.md) : `GET /api/health`
+* [Health](v1/health.md) : `GET /api/v1/health`
 
-## Endpoints that require Authentication
+### Endpoints that require Authentication
 
-Closed endpoints require a valid `X-API-Key` to be included in the header of the request. Token needs to be configured in .env file (as a environment variable `API_KEY`) and can be generated using `php bin/console api:generate` command.
+Closed endpoints require a valid `X-Davis-API-Token` to be included in the header of the request. Token needs to be configured in .env file (as a environment variable `API_KEY`) and can be generated using `php bin/console api:generate` command.
 
-### User related
+#### User related
 
 Each endpoint displays information related to the User:
 
-* [Get Users](users/all.md) : `GET /api/users`
-* [Get User Details](users/details.md) : `GET /api/users/:username`
+* [Get Users](v1/users/all.md) : `GET /api/v1/users`
+* [Get User Details](v1/users/details.md) : `GET /api/v1/users/:username`
 
-### Calendars related
+#### Calendars related
 
 Endpoints for viewing and modifying user calendars.
 
-* [Show All User Calendars](calendars/all.md) : `GET /api/calendars/:username`
-* [Show User Calendar Details](calendars/details.md) : `GET /api/calendars/:username/:calendar_id`
-* [Show User Calendar Shares](calendars/shares.md) : `GET /api/calendars/:username/shares/:calendar_id`
-* [Share User Calendar](calendars/share_add.md) : `POST /api/calendars/:username/share/:calendar_id/add`
-* [Remove Share User Calendar](calendars/share_remove.md) : `POST /api/calendars/:username/share/:calendar_id/remove`
+* [Show All User Calendars](v1/calendars/all.md) : `GET /api/v1/calendars/:username`
+* [Show User Calendar Details](v1/calendars/details.md) : `GET /api/v1/calendars/:username/:calendar_id`
+* [Create User Calendar](v1/calendars/create.md) : `POST /api/v1/calendars/:username/create`
+* [Edit User Calendar](v1/calendars/edit.md) : `POST /api/v1/calendars/:username/:calendar_id/edit`
+* [Show User Calendar Shares](v1/calendars/shares.md) : `GET /api/v1/calendars/:username/shares/:calendar_id`
+* [Share User Calendar](v1/calendars/share_add.md) : `POST /api/v1/calendars/:username/share/:calendar_id/add`
+* [Remove Share User Calendar](v1/calendars/share_remove.md) : `POST /api/v1/calendars/:username/share/:calendar_id/remove`

docs/api/calendars/share_add.md

@@ -2,7 +2,7 @@
 
 Gets a list of all available calendars for a specific user.
 
-**URL** : `/api/calendars/:username`
+**URL** : `/api/v1/calendars/:username`
 
 **Method** : `GET`
 
@@ -17,7 +17,7 @@ Gets a list of all available calendars for a specific user.
 **URL example**
 
 ```json
-/api/calendars/jdoe
+/api/v1/calendars/jdoe
 ```
 
 ## Success Response
@@ -53,15 +53,8 @@ Gets a list of all available calendars for a specific user.
 			}
 		],
 		"subscriptions": []
-	}
-}
-```
-
-Shown when there are no users in Davis:
-```json
-{
-	"status": "success",
-	"data": []
+	},
+	"timestamp": "2026-01-23T15:01:33+01:00"
 }
 ```
 
@@ -73,34 +66,45 @@ Shown when user does not have calendars:
 		"user_calendars": [],
 		"shared_calendars": [],
 		"subscriptions": []
-	}
+	},
+	"timestamp": "2026-01-23T15:01:33+01:00"
 }
 ```
 
 ## Error Response
 
-**Condition** : If 'X-API-Key' is not present or mismatched in headers.
+**Condition** : If 'X-Davis-API-Token' is not present or mismatched in headers.
 
 **Code** : `401 UNAUTHORIZED`
 
 **Content** :
 
 ```json
 {
-	"status": "error",
-	"message": "Unauthorized"
+	"message": "No API token provided",
+	"timestamp": "2026-01-23T15:01:33+01:00"
+}
+```
+
+or
+
+```json
+{
+	"message": "Invalid API token",
+	"timestamp": "2026-01-23T15:01:33+01:00"
 }
 ```
 
-**Condition** : If ':username' is not a valid string containing chars: `a-zA-Z0-9_-`.
+**Condition** : If user is not found.
 
-**Code** : `400 BAD REQUEST`
+**Code** : `404 NOT FOUND`
 
 **Content** :
 
 ```json
 {
 	"status": "error", 
-    "message": "Invalid Username"
+    "message": "User Not Found",
+	"timestamp": "2026-01-23T15:01:33+01:00"
 }
 ```