updated api

Author: tobias-reese

README.md

@@ -1,5 +1,5 @@
 # timular-api
- Welcome to the documentation of Timeular Public API v1.  You can try all requests here, in documentation, with use of `Try it out` button (available in each endpoint description after folding it out).  Most of endpoints are secured. In order to access them you have to provide *Access Token*. To do so, click on `Authorize` button below and provide `Bearer <your_access_token>` as a value for `Authorization` request header. To obtain *Access Token* you have to sign-in with pair of *API Key* and *API Secret* first. API Key & API Secret can be generated on [Profile website](https://profile.timeular.com/#/app/) or, if you have Access Token already, with `POST` request to `/developer/api-access`.  **Warning:** authentication flow may change soon due to active development of Timeular and its API.  If you have any questions, please visit [Support page](http://support.timeular.com) and ask them there.  Happy API browsing!
+ Welcome to the documentation of Timeular Public API v2. If you want to have a look at the older and deprecated API v1 please just click on the following link: [Timeular Public API v1](./?v=v1)  You can try all requests here, in documentation, with use of `Try it out` button (available in each endpoint description after folding it out).  Most of endpoints are secured. In order to access them you have to provide *Access Token*. To do so, click on `Authorize` button below and provide `'Bearer *your_access_token*'` as a value for `Authorization` request header. To obtain *Access Token* you have to sign-in with pair of *API Key* and *API Secret* first. API Key & API Secret can be generated on [Profile website](https://profile.timeular.com/#/app/) or, if you have Access Token already, with `POST` request to `/developer/api-access`.  **Warning:** authentication flow may change soon due to active development of Timeular and its API.  If you have any questions, please visit [Support page](http://support.timeular.com) and ask them there.  Happy API browsing!
 
 This Python package is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:
 
@@ -65,35 +65,34 @@ except ApiException as e:
 
 ## Documentation for API Endpoints
 
-All URIs are relative to *https://api.timeular.com/api/v1/*
+All URIs are relative to *https://api.timeular.com/api/v2/*
 
 Class | Method | HTTP request | Description
 ------------ | ------------- | ------------- | -------------
 *AuthenticationApi* | [**developer_sign_in**](docs/AuthenticationApi.md#developer_sign_in) | **POST** /developer/sign-in | Sign-in with API Key &amp; API Secret
+*AuthenticationApi* | [**generate_api_key**](docs/AuthenticationApi.md#generate_api_key) | **POST** /developer/api-access | Generate new API Key &amp; API Secret
 *AuthenticationApi* | [**get_api_key**](docs/AuthenticationApi.md#get_api_key) | **GET** /developer/api-access | Fetch API Key
-*AuthenticationApi* | [**get_api_key_0**](docs/AuthenticationApi.md#get_api_key_0) | **POST** /developer/api-access | Generate new API Key &amp; API Secret
 *IntegrationsApi* | [**get_integration**](docs/IntegrationsApi.md#get_integration) | **GET** /integrations | List enabled Integrations
-*ProfileApi* | [**get_profile**](docs/ProfileApi.md#get_profile) | **GET** /user/profile | Fetch User&#39;s Profile
 *TimeTrackingActivitiesApi* | [**archive_activity**](docs/TimeTrackingActivitiesApi.md#archive_activity) | **DELETE** /activities/{activityId} | Archive an Activity
 *TimeTrackingActivitiesApi* | [**assign_activity_to_device_side**](docs/TimeTrackingActivitiesApi.md#assign_activity_to_device_side) | **POST** /activities/{activityId}/device-side/{deviceSide} | Assign an Activity to Device Side
 *TimeTrackingActivitiesApi* | [**create_activity**](docs/TimeTrackingActivitiesApi.md#create_activity) | **POST** /activities | Create an Activity
 *TimeTrackingActivitiesApi* | [**edit_activity**](docs/TimeTrackingActivitiesApi.md#edit_activity) | **PATCH** /activities/{activityId} | Edit an Activity
 *TimeTrackingActivitiesApi* | [**get_activities**](docs/TimeTrackingActivitiesApi.md#get_activities) | **GET** /activities | List all Activities
 *TimeTrackingActivitiesApi* | [**get_archived_activities**](docs/TimeTrackingActivitiesApi.md#get_archived_activities) | **GET** /archived-activities | List all Archived Activities
-*TimeTrackingActivitiesApi* | [**get_tags_and_mentions_of_activity**](docs/TimeTrackingActivitiesApi.md#get_tags_and_mentions_of_activity) | **GET** /activities/{activityId}/tags-and-mentions | Fetch Tags &amp; Mentions of given Activity
 *TimeTrackingActivitiesApi* | [**unassign_activity_from_device_side**](docs/TimeTrackingActivitiesApi.md#unassign_activity_from_device_side) | **DELETE** /activities/{activityId}/device-side/{deviceSide} | Unassign an Activity from a Device Side
 *TimeTrackingCurrentTrackingApi* | [**edit_tracking**](docs/TimeTrackingCurrentTrackingApi.md#edit_tracking) | **PATCH** /tracking/{activityId} | Edit Tracking
 *TimeTrackingCurrentTrackingApi* | [**get_current_tracking**](docs/TimeTrackingCurrentTrackingApi.md#get_current_tracking) | **GET** /tracking | Show current Tracking
 *TimeTrackingCurrentTrackingApi* | [**start_tracking**](docs/TimeTrackingCurrentTrackingApi.md#start_tracking) | **POST** /tracking/{activityId}/start | Start Tracking
 *TimeTrackingCurrentTrackingApi* | [**stop_tracking**](docs/TimeTrackingCurrentTrackingApi.md#stop_tracking) | **POST** /tracking/{activityId}/stop | Stop Tracking
-*TimeTrackingDevicesApi* | [**activate_device**](docs/TimeTrackingDevicesApi.md#activate_device) | **POST** /devices/{deviceSerial}/active | Activate a Device
-*TimeTrackingDevicesApi* | [**activate_device_0**](docs/TimeTrackingDevicesApi.md#activate_device_0) | **PATCH** /devices/{deviceSerial} | Edit a Device
-*TimeTrackingDevicesApi* | [**deactivate_device**](docs/TimeTrackingDevicesApi.md#deactivate_device) | **DELETE** /devices/{deviceSerial}/active | Deactivate a Device
+*TimeTrackingDevicesApi* | [**activate_device**](docs/TimeTrackingDevicesApi.md#activate_device) | **POST** /devices/{deviceSerial}/active | Sets the status of a Device to active
+*TimeTrackingDevicesApi* | [**deactivate_device**](docs/TimeTrackingDevicesApi.md#deactivate_device) | **DELETE** /devices/{deviceSerial}/active | Removes the active status from the given Device
 *TimeTrackingDevicesApi* | [**disable_device**](docs/TimeTrackingDevicesApi.md#disable_device) | **POST** /devices/{deviceSerial}/disabled | Disable a Device
-*TimeTrackingDevicesApi* | [**eanble_device**](docs/TimeTrackingDevicesApi.md#eanble_device) | **DELETE** /devices/{deviceSerial}/disabled | Enable a Device
-*TimeTrackingDevicesApi* | [**forget_device**](docs/TimeTrackingDevicesApi.md#forget_device) | **DELETE** /devices/{deviceSerial} | Forget known Device
+*TimeTrackingDevicesApi* | [**edit_device**](docs/TimeTrackingDevicesApi.md#edit_device) | **PATCH** /devices/{deviceSerial} | Edit a Device
+*TimeTrackingDevicesApi* | [**enable_device**](docs/TimeTrackingDevicesApi.md#enable_device) | **DELETE** /devices/{deviceSerial}/disabled | Enable a Device
 *TimeTrackingDevicesApi* | [**get_known_devices**](docs/TimeTrackingDevicesApi.md#get_known_devices) | **GET** /devices | List all known Devices
+*TimeTrackingDevicesApi* | [**remove_device**](docs/TimeTrackingDevicesApi.md#remove_device) | **DELETE** /devices/{deviceSerial} | Remove known Device
 *TimeTrackingReportsApi* | [**generate_csv_report**](docs/TimeTrackingReportsApi.md#generate_csv_report) | **GET** /report/{startTimestamp}/{stopTimestamp} | Generate CSV Report
+*TimeTrackingTagsMentionsApi* | [**get_tags_and_mentions**](docs/TimeTrackingTagsMentionsApi.md#get_tags_and_mentions) | **GET** /tags-and-mentions | Fetch Tags &amp; Mentions
 *TimeTrackingTimeEntriesApi* | [**create_time_entry**](docs/TimeTrackingTimeEntriesApi.md#create_time_entry) | **POST** /time-entries | Create Time Entry
 *TimeTrackingTimeEntriesApi* | [**delete_time_entry**](docs/TimeTrackingTimeEntriesApi.md#delete_time_entry) | **DELETE** /time-entries/{timeEntryId} | Delete a Time Entry
 *TimeTrackingTimeEntriesApi* | [**edit_time_entry**](docs/TimeTrackingTimeEntriesApi.md#edit_time_entry) | **PATCH** /time-entries/{timeEntryId} | Edit a Time Entry
@@ -122,7 +121,9 @@ Class | Method | HTTP request | Description
  - [ErrorResponse](docs/ErrorResponse.md)
  - [IntegrationsResponse](docs/IntegrationsResponse.md)
  - [MentionResponse](docs/MentionResponse.md)
- - [ProfileResponse](docs/ProfileResponse.md)
+ - [Note](docs/Note.md)
+ - [NoteMention](docs/NoteMention.md)
+ - [NoteTag](docs/NoteTag.md)
  - [StartTrackingRequest](docs/StartTrackingRequest.md)
  - [StartedTrackingResponse](docs/StartedTrackingResponse.md)
  - [StopTrackingRequest](docs/StopTrackingRequest.md)

docs/AuthenticationApi.md

@@ -1,20 +1,20 @@
 # timular-api.AuthenticationApi
 
-All URIs are relative to *https://api.timeular.com/api/v1/*
+All URIs are relative to *https://api.timeular.com/api/v2/*
 
 Method | HTTP request | Description
 ------------- | ------------- | -------------
 [**developer_sign_in**](AuthenticationApi.md#developer_sign_in) | **POST** /developer/sign-in | Sign-in with API Key & API Secret
+[**generate_api_key**](AuthenticationApi.md#generate_api_key) | **POST** /developer/api-access | Generate new API Key & API Secret
 [**get_api_key**](AuthenticationApi.md#get_api_key) | **GET** /developer/api-access | Fetch API Key
-[**get_api_key_0**](AuthenticationApi.md#get_api_key_0) | **POST** /developer/api-access | Generate new API Key & API Secret
 
 
 # **developer_sign_in**
 > DeveloperSignInResponse developer_sign_in(api_key_and_api_secret=api_key_and_api_secret)
 
 Sign-in with API Key & API Secret
 
-With this endpoint you can obtain Access Token required to access secured endpoints. To do so, you have to provide API Key & API Secret. They can be generated on [Profile website](https://profile.timeular.com/#/app/) or, if you have Access Token already, with `POST` request to `/developer/api-access`.
+With this endpoint you can obtain Access Token required to access secured endpoints. To do so, you have to provide API Key & API Secret. They can be generated on [Profile website](https://profile.timeular.com/#/app/) or, if you have Access Token already, with `POST` request to `/developer/api-access`.  If you possess your Access Token you can now add this inside an HTTP header field  `Authorization` as value `'Bearer *your_access_token*'` to access restricted endpoints.
 
 ### Example
 ```python
@@ -57,12 +57,12 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **get_api_key**
-> DeveloperApiAccessResponse get_api_key()
+# **generate_api_key**
+> DeveloperFullApiAccessResponse generate_api_key()
 
-Fetch API Key
+Generate new API Key & API Secret
 
-With this endpoint you can fetch your API Key (or `null` if you haven't generated any yet). You cannot obtain an API Secret in such way, because it's visible only once, after generation. If you have lost your API Secret, please generate a new pair of API Key & API Secret.
+With this endpoint you can generate a new pair of API Key & API Secret. Every time you generate a new pair, an old one becomes invalid. Your API Secret won't be accessible later, so please note it down in some secret place. If you have lost your API Secret, you can generate a new pair of API Key & API Secret here.
 
 ### Example
 ```python
@@ -82,19 +82,19 @@ configuration.api_key['Authorization'] = 'YOUR_API_KEY'
 api_instance = timular-api.AuthenticationApi(timular-api.ApiClient(configuration))
 
 try:
-    # Fetch API Key
-    api_response = api_instance.get_api_key()
+    # Generate new API Key & API Secret
+    api_response = api_instance.generate_api_key()
     pprint(api_response)
 except ApiException as e:
-    print("Exception when calling AuthenticationApi->get_api_key: %s\n" % e)
+    print("Exception when calling AuthenticationApi->generate_api_key: %s\n" % e)
 ```
 
 ### Parameters
 This endpoint does not need any parameter.
 
 ### Return type
 
-[**DeveloperApiAccessResponse**](DeveloperApiAccessResponse.md)
+[**DeveloperFullApiAccessResponse**](DeveloperFullApiAccessResponse.md)
 
 ### Authorization
 
@@ -107,12 +107,12 @@ This endpoint does not need any parameter.
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **get_api_key_0**
-> DeveloperFullApiAccessResponse get_api_key_0()
+# **get_api_key**
+> DeveloperApiAccessResponse get_api_key()
 
-Generate new API Key & API Secret
+Fetch API Key
 
-With this endpoint you can generate new pair of API Key & API Secret. Every time you generate a new pair, an old one becomes invalid. Your API Secret won't be accessible later, so please note it down in some secret place. If you have lost your API Secret, you can generate a new pair of API Key & API Secret here.
+With this endpoint you can fetch your API Key (or `null` if you haven't generated any yet). You cannot obtain an API Secret in such way, because it's visible only once, after generation. If you have lost your API Secret, please generate a new pair of API Key & API Secret.
 
 ### Example
 ```python
@@ -132,19 +132,19 @@ configuration.api_key['Authorization'] = 'YOUR_API_KEY'
 api_instance = timular-api.AuthenticationApi(timular-api.ApiClient(configuration))
 
 try:
-    # Generate new API Key & API Secret
-    api_response = api_instance.get_api_key_0()
+    # Fetch API Key
+    api_response = api_instance.get_api_key()
     pprint(api_response)
 except ApiException as e:
-    print("Exception when calling AuthenticationApi->get_api_key_0: %s\n" % e)
+    print("Exception when calling AuthenticationApi->get_api_key: %s\n" % e)
 ```
 
 ### Parameters
 This endpoint does not need any parameter.
 
 ### Return type
 
-[**DeveloperFullApiAccessResponse**](DeveloperFullApiAccessResponse.md)
+[**DeveloperApiAccessResponse**](DeveloperApiAccessResponse.md)
 
 ### Authorization
 

docs/EditTrackingRequest.md

@@ -3,7 +3,7 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**note** | **str** |  | [optional] 
+**note** | [**Note**](Note.md) |  | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/IntegrationsApi.md

@@ -1,6 +1,6 @@
 # timular-api.IntegrationsApi
 
-All URIs are relative to *https://api.timeular.com/api/v1/*
+All URIs are relative to *https://api.timeular.com/api/v2/*
 
 Method | HTTP request | Description
 ------------- | ------------- | -------------

docs/Note.md

@@ -0,0 +1,12 @@
+# Note
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**text** | **str** |  | [optional] 
+**tags** | [**list[NoteTag]**](NoteTag.md) |  | [optional] 
+**mentions** | [**list[NoteMention]**](NoteMention.md) |  | [optional] 
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

docs/NoteMention.md

@@ -0,0 +1,11 @@
+# NoteMention
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**indices** | **list[int]** |  | [optional] 
+**key** | **str** |  | [optional] 
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

docs/NoteTag.md

@@ -0,0 +1,11 @@
+# NoteTag
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**indices** | **list[int]** |  | [optional] 
+**key** | **str** |  | [optional] 
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

docs/TimeEntryCreationRequest.md

@@ -6,7 +6,7 @@ Name | Type | Description | Notes
 **activity_id** | **str** |  | 
 **started_at** | **str** |  | 
 **stopped_at** | **str** |  | 
-**name** | **str** |  | [optional] 
+**note** | [**Note**](Note.md) |  | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/TimeEntryEditionRequest.md

@@ -6,7 +6,7 @@ Name | Type | Description | Notes
 **activity_id** | **str** |  | [optional] 
 **started_at** | **str** |  | [optional] 
 **stopped_at** | **str** |  | [optional] 
-**note** | **str** |  | [optional] 
+**note** | [**Note**](Note.md) |  | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/TimeEntryResponse.md

@@ -6,7 +6,7 @@ Name | Type | Description | Notes
 **id** | **str** |  | [optional] 
 **activity** | [**TimeEntryActivityResponse**](TimeEntryActivityResponse.md) |  | [optional] 
 **duration** | [**TimeEntryDurationResponse**](TimeEntryDurationResponse.md) |  | [optional] 
-**note** | **str** |  | [optional] 
+**note** | [**Note**](Note.md) |  | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)