topdesk-mcp 0.2.0__tar.gz

topdesk_mcp-0.2.0/.github/copilot-instructions.md

@@ -0,0 +1,7 @@
+<!-- Use this file to provide workspace-specific custom instructions to Copilot. For more details, visit https://code.visualstudio.com/docs/copilot/copilot-customization#_use-a-githubcopilotinstructionsmd-file -->
+
+This is an MCP Server project. You can find more info and examples at https://modelcontextprotocol.io/llms-full.txt
+
+This MCP server exposes the Topdesk API using the TOPdeskPy SDK: https://github.com/TwinkelToe/TOPdeskPy
+
+Reference the SDK documentation and MCP protocol documentation when generating code for this project.

topdesk_mcp-0.2.0/.github/workflows/pypi.yml

@@ -0,0 +1,26 @@
+on:
+  release:
+    types: [created]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.12'
+        cache: pip
+        cache-dependency-path: '**/pyproject.toml'
+    - name: Build
+      run: |
+        pip install uv
+        uv venv
+        uv pip install setuptools wheel build
+        uv build
+
+    - name: Publish
+      uses: pypa/gh-action-pypi-publish@release/v1

topdesk_mcp-0.2.0/.github/workflows/pytest.yml

@@ -0,0 +1,25 @@
+name: Run Pytest
+
+on:
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Run pytest
+        run: |
+            pip install uv
+            uv venv
+            uv pip install -e .
+            uv pip install -e ".[dev]" 
+            uv run pytest

topdesk_mcp-0.2.0/.gitignore

@@ -0,0 +1,5 @@
+**/fastmcp-README.md
+**/__pycache__
+**/.pytest_cache
+**/.venv
+topdesk_mcp.log

topdesk_mcp-0.2.0/.vscode/launch.json

@@ -0,0 +1,14 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Python Debugger: Module",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "topdesk_mcp.main"
+        }
+    ]
+}

topdesk_mcp-0.2.0/.vscode/mcp.json

@@ -0,0 +1,13 @@
+{
+  "servers": {
+    "topdesk-mcp": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+        "--from", 
+        "git+https://github.com/dbsanfte/topdesk-mcp",
+        "topdesk-mcp"
+      ],
+    }
+  }
+}

topdesk_mcp-0.2.0/.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+    "python.testing.pytestArgs": [
+        "topdesk_mcp"
+    ],
+    "python.testing.unittestEnabled": false,
+    "python.testing.pytestEnabled": true
+}

topdesk_mcp-0.2.0/.vscode/tasks.json

@@ -0,0 +1,16 @@
+{
+	"version": "2.0.0",
+	"tasks": [
+		{
+			"type": "shell",
+			"label": "Run MCP Server",
+			"command": "python",
+			"args": [
+				"main.py"
+			],
+			"group": "build",
+			"isBackground": false,
+			"problemMatcher": []
+		}
+	]
+}

topdesk_mcp-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 David Sanftenberg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

topdesk_mcp-0.2.0/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: topdesk-mcp
+Version: 0.2.0
+Summary: MCP server for TOPdesk API using FastMCP and TOPdeskPy SDK
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: fastmcp
+Requires-Dist: requests
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# topdesk-mcp
+
+This project is a Model Context Protocol (MCP) server implemented in Python. It exposes the Topdesk API via the TOPdeskPy SDK.
+
+## Project Purpose
+- Acts as an MCP server to bridge MCP clients with the Topdesk API.
+- Uses the [TOPdeskPy SDK](https://github.com/TwinkelToe/TOPdeskPy) (with some modifications) for all Topdesk API interactions.
+
+## MCP Config JSON
+```
+{
+  "servers": {
+    "topdesk-mcp": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+        "--from", 
+        "git+https://github.com/dbsanfte/topdesk-mcp@master",
+        "topdesk-mcp"
+      ],
+      "env": {
+         "TOPDESK_URL": "<your topdesk URL>",
+         "TOPDESK_USERNAME": "<your topdesk username>",
+         "TOPDESK_PASSWORD": "<your topdesk api key>"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+* `TOPDESK_URL`: The base URL of your Topdesk instance. e.g. `https://yourcompany.topdesk.net`
+* `TOPDESK_USERNAME`: The username you generated the API token against.
+* `TOPDESK_PASSWORD`: Your API token
+* `TOPDESK_MCP_TRANSPORT`: (Optional) The transport to use: 'stdio', 'streamable-http', 'sse'. Defaults to 'stdio'.
+* `TOPDESK_MCP_HOST`: (Optional) The host to listen on (for 'streamable-http' and 'sse'). Defaults to '0.0.0.0'.
+* `TOPDESK_MCP_PORT`: (Optional) The port to listen on (for 'streamable-http' and 'sse'). Defaults to '3030'.
+
+## Setup for Local Development
+1. Ensure Python 3.11+ is installed.
+2. Create and activate a virtual environment:
+
+   **PowerShell:**
+   ```powershell
+   python -m venv .venv
+   .venv\Scripts\Activate.ps1
+   ```
+
+   **Bash:**
+   ```bash
+   python3 -m venv .venv
+   source .venv/bin/activate
+   ```
+
+3. Install dependencies:
+   ```
+   pip install uv
+   uv pip install -r requirements.txt
+   ```
+   
+4. Run:
+   ```
+   python -m topdesk_mcp.main
+   ```
+   
+### Notes:
+* The server skeleton was generated using the official MCP server template.
+* Contributions are welcome.
+
+## Package Structure
+```
+topdesk_mcp/  # Directory for the MCP server package
+    __init__.py     # Marks as a Python package
+    main.py         # Entry point for the MCP server
+    
+    _topdesk_sdk.py # TOPdeskPy SDK
+    _incident.py    # Incidents API
+    _operator.py    # Operator API
+    _person.py      # Person API
+    _utils.py       # Helper methods for Requests
+```
+
+## References
+- [MCP Protocol Documentation](https://modelcontextprotocol.io/llms-full.txt)
+- [TOPdeskPy SDK](https://github.com/TwinkelToe/TOPdeskPy)
+- [FastMCP](https://github.com/jlowin/fastmcp)
+
+## License
+MIT license.

topdesk_mcp-0.2.0/README.md

@@ -0,0 +1,89 @@
+# topdesk-mcp
+
+This project is a Model Context Protocol (MCP) server implemented in Python. It exposes the Topdesk API via the TOPdeskPy SDK.
+
+## Project Purpose
+- Acts as an MCP server to bridge MCP clients with the Topdesk API.
+- Uses the [TOPdeskPy SDK](https://github.com/TwinkelToe/TOPdeskPy) (with some modifications) for all Topdesk API interactions.
+
+## MCP Config JSON
+```
+{
+  "servers": {
+    "topdesk-mcp": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+        "--from", 
+        "git+https://github.com/dbsanfte/topdesk-mcp@master",
+        "topdesk-mcp"
+      ],
+      "env": {
+         "TOPDESK_URL": "<your topdesk URL>",
+         "TOPDESK_USERNAME": "<your topdesk username>",
+         "TOPDESK_PASSWORD": "<your topdesk api key>"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+* `TOPDESK_URL`: The base URL of your Topdesk instance. e.g. `https://yourcompany.topdesk.net`
+* `TOPDESK_USERNAME`: The username you generated the API token against.
+* `TOPDESK_PASSWORD`: Your API token
+* `TOPDESK_MCP_TRANSPORT`: (Optional) The transport to use: 'stdio', 'streamable-http', 'sse'. Defaults to 'stdio'.
+* `TOPDESK_MCP_HOST`: (Optional) The host to listen on (for 'streamable-http' and 'sse'). Defaults to '0.0.0.0'.
+* `TOPDESK_MCP_PORT`: (Optional) The port to listen on (for 'streamable-http' and 'sse'). Defaults to '3030'.
+
+## Setup for Local Development
+1. Ensure Python 3.11+ is installed.
+2. Create and activate a virtual environment:
+
+   **PowerShell:**
+   ```powershell
+   python -m venv .venv
+   .venv\Scripts\Activate.ps1
+   ```
+
+   **Bash:**
+   ```bash
+   python3 -m venv .venv
+   source .venv/bin/activate
+   ```
+
+3. Install dependencies:
+   ```
+   pip install uv
+   uv pip install -r requirements.txt
+   ```
+   
+4. Run:
+   ```
+   python -m topdesk_mcp.main
+   ```
+   
+### Notes:
+* The server skeleton was generated using the official MCP server template.
+* Contributions are welcome.
+
+## Package Structure
+```
+topdesk_mcp/  # Directory for the MCP server package
+    __init__.py     # Marks as a Python package
+    main.py         # Entry point for the MCP server
+    
+    _topdesk_sdk.py # TOPdeskPy SDK
+    _incident.py    # Incidents API
+    _operator.py    # Operator API
+    _person.py      # Person API
+    _utils.py       # Helper methods for Requests
+```
+
+## References
+- [MCP Protocol Documentation](https://modelcontextprotocol.io/llms-full.txt)
+- [TOPdeskPy SDK](https://github.com/TwinkelToe/TOPdeskPy)
+- [FastMCP](https://github.com/jlowin/fastmcp)
+
+## License
+MIT license.

topdesk_mcp-0.2.0/pyproject.toml

@@ -0,0 +1,56 @@
+[project]
+name = "topdesk-mcp"
+version = "0.2.0"
+description = "MCP server for TOPdesk API using FastMCP and TOPdeskPy SDK"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+  "fastmcp",
+  "requests"
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.uv]
+trusted-hosts = [
+  "pypi.org",
+  "files.pythonhosted.org"
+]
+
+[project.scripts]
+topdesk-mcp = "topdesk_mcp.main:main"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"
+python_classes = "Test*"
+python_functions = "test_*"
+filterwarnings = [
+    "ignore::DeprecationWarning",
+    "ignore::PendingDeprecationWarning",
+]
+markers = [
+    "integration: marks tests as integration tests",
+    "unit: marks tests as unit tests",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+]
+
+[tool.coverage.run]
+source = ["topdesk_mcp"]
+omit = ["tests/*", "**/__init__.py"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "pass",
+]

topdesk_mcp-0.2.0/topdesk_mcp/__init__.py

@@ -0,0 +1,2 @@
+# topdesk_mcp/__init__.py
+# This file marks the directory as a Python package.

topdesk_mcp-0.2.0/topdesk_mcp/_incident.py

@@ -0,0 +1,256 @@
+from topdesk_mcp import _utils
+import re
+import logging
+
+class incident:
+
+    def __init__(self, topdesk_url, credpair):
+        self._topdesk_url = topdesk_url
+        self._credpair = credpair
+        self.utils = _utils.utils(self._topdesk_url, self._credpair)
+        self.action = self._action(self._topdesk_url, self._credpair)
+        self.request = self._request(self._topdesk_url, self._credpair)
+        self.timespent = self._timespent(self._topdesk_url, self._credpair)
+        self._logger = logging.getLogger(__name__)
+        self._logger.debug("Incident class initialized with URL: %s", self._topdesk_url)
+        self._logger.debug("Incident class initialized with credentials: %s", self._credpair)
+
+    def get(self, incident):
+        if self.utils.is_valid_uuid(incident):
+            return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/id/{}".format(incident)))
+        else:
+            return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/number/{}".format(incident)))
+
+    def deescalate(self, incident, reason_id=None):
+        if reason_id:
+            param = {'id': reason_id}
+        if self.utils.is_valid_uuid(incident):    
+            return self.utils.handle_topdesk_response(self.utils.put_to_topdesk("/tas/api/incidents/id/{}/deescalate".format(incident), param))
+        else:
+            return self.utils.handle_topdesk_response(self.utils.put_to_topdesk("/tas/api/incidents/number/{}/deescalate".format(incident), param))
+
+    def escalate(self, incident, reason_id=None):
+        if reason_id:
+            param = {'id': reason_id}
+        if self.utils.is_valid_uuid(incident):    
+            return self.utils.handle_topdesk_response(self.utils.put_to_topdesk("/tas/api/incidents/id/{}/escalate".format(incident), param))
+        else:
+            return self.utils.handle_topdesk_response(self.utils.put_to_topdesk("/tas/api/incidents/number/{}/escalate".format(incident), param))
+
+    def get_progress_trail(self, incident, inlineimages=False, non_api_attachments_url=False, page_size=100):
+        ext_uri= { 'inlineimages': inlineimages, 'non_api_attachments_url': non_api_attachments_url }
+        if self.utils.is_valid_uuid(incident):
+            return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/id/{}/progresstrail".format(incident), page_size=page_size, extended_uri=ext_uri))
+        else:
+            return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/number/{}/progresstrail".format(incident), page_size=page_size, extended_uri=ext_uri))
+        
+    def patch(self, incident, **kwargs):
+        if self.utils.is_valid_uuid(incident):
+            return self.utils.handle_topdesk_response(self.utils.patch_to_topdesk("/tas/api/incidents/id/{}".format(incident), self.utils.add_id_jsonbody(**kwargs)))
+        else:
+            return self.utils.handle_topdesk_response(self.utils.patch_to_topdesk("/tas/api/incidents/number/{}".format(incident), self.utils.add_id_jsonbody(**kwargs)))
+
+    class _action:
+        
+        def __init__(self, topdesk_url, credpair):
+            self._topdesk_url = topdesk_url
+            self._credpair = credpair
+            self.utils = _utils.utils(self._topdesk_url, self._credpair)
+            self._logger = logging.getLogger(__name__)
+            self._logger.debug("TOPdesk API action object initialised.")
+
+        def get_list(self, incident, inlineimages=False, non_api_attachments_url=False, page_size=100):
+            ext_uri= { 'inlineimages': inlineimages, 'non_api_attachments_url': non_api_attachments_url }
+            if self.utils.is_valid_uuid(incident):
+                return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/id/{}/actions".format(incident), page_size=page_size, extended_uri=ext_uri))
+            else:
+                return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/number/{}/actions".format(incident), page_size=page_size, extended_uri=ext_uri))
+
+        def get(self, incident, actions_id, inlineimages=False, non_api_attachments_url=False):
+            ext_uri= { 'inlineimages': inlineimages, 'non_api_attachments_url': non_api_attachments_url }
+            if self.utils.is_valid_uuid(incident):
+                return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/id/{}/actions/{}".format(incident, actions_id), page_size=10, extended_uri=ext_uri))
+            else:
+                return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/number/{}/actions/{}".format(incident, actions_id), page_size=10, extended_uri=ext_uri))
+
+        def delete(self, incident, actions_id):
+            if self.utils.is_valid_uuid(incident):
+                return self.utils.handle_topdesk_response(self.utils.delete_from_topdesk("/tas/api/incidents/id/{}/actions/{}".format(incident, actions_id), None))
+            else:
+                return self.utils.handle_topdesk_response(self.utils.delete_from_topdesk("/tas/api/incidents/number/{}/actions/{}".format(incident, actions_id), None))
+
+    class _request:
+
+        def __init__(self, topdesk_url, credpair):
+            self._topdesk_url = topdesk_url
+            self._credpair = credpair
+            self.utils = _utils.utils(self._topdesk_url, self._credpair)
+            self._logger = logging.getLogger(__name__)
+            self._logger.debug("TOPdesk API request object initialised.")
+
+        def get_list(self, incident, inlineimages=False, non_api_attachments_url=False, page_size=100):
+            ext_uri= { 'inlineimages': inlineimages, 'non_api_attachments_url': non_api_attachments_url }
+            if self.utils.is_valid_uuid(incident):
+                return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/id/{}/requests".format(incident), page_size=page_size, extended_uri=ext_uri))
+            else:
+                return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/number/{}/requests".format(incident), page_size=page_size, extended_uri=ext_uri))
+
+        def get(self, incident, request_id, inlineimages=False, non_api_attachments_url=False):
+            ext_uri= { 'inlineimages': inlineimages, 'non_api_attachments_url': non_api_attachments_url }
+            if self.utils.is_valid_uuid(incident):
+                return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/id/{}/actions/{}".format(incident, request_id), page_size=10, extended_uri=ext_uri))
+            else:
+                return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/number/{}/actions/{}".format(incident, request_id), page_size=10, extended_uri=ext_uri))
+
+        def delete(self, incident, request_id):
+            if self.utils.is_valid_uuid(incident):
+                return self.utils.handle_topdesk_response(self.utils.delete_from_topdesk("/tas/api/incidents/id/{}/actions/{}".format(incident, request_id), None))
+            else:
+                return self.utils.handle_topdesk_response(self.utils.delete_from_topdesk("/tas/api/incidents/number/{}/actions/{}".format(incident, request_id), None))
+
+    class _timespent:
+
+        def __init__(self, topdesk_url, credpair):
+            self._topdesk_url = topdesk_url
+            self._credpair = credpair
+            self.utils = _utils.utils(self._topdesk_url, self._credpair)
+            self._logger = logging.getLogger(__name__)
+            self._logger.debug("TOPdesk API timespent object initialised.")
+
+        def get(self, incident):
+            if self.utils.is_valid_uuid(incident):    
+                return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/id/{}/timespent".format(incident)))
+            else:
+                return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/number/{}/timespent".format(incident)))
+
+        def register(self, incident, timespent, **kwargs):
+            param = {}
+            if kwargs:
+                param = kwargs 
+            param['timespent'] =  timespent            
+            if self.utils.is_valid_uuid(incident):    
+                return self.utils.handle_topdesk_response(self.utils.post_to_topdesk("/tas/api/incidents/id/{}/timespent".format(incident), param))
+            else:
+                return self.utils.handle_topdesk_response(self.utils.post_to_topdesk("/tas/api/incidents/number/{}/timespent".format(incident), param))
+
+    def durations(self):
+        return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/durations"))
+
+    def statuses(self):
+        return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/statuses"))
+
+    def deescalation_reasons(self):
+        return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/deescalation-reasons"))
+    
+    def escalation_reasons(self):
+        return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/escalation-reasons"))
+    
+    def service_windows(self):
+        return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/slas/services"))
+
+    def call_types(self):
+        return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/call_types"))
+
+    def closure_codes(self):
+        return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/closure_codes"))
+
+    def entry_types(self):
+        return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/entry_types"))
+
+    def categorys(self):
+        return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/categories"))
+
+    def subcategorys(self):
+        return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/subcategories"))
+
+    def impacts(self):
+        return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/impacts"))
+
+    def priorities(self):
+        return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/priorities"))
+
+    def urgencies(self):
+        return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/urgencies"))
+
+    def get_id_impact(self, query):
+        result = self.impacts()
+        canidates = list()
+        for impact in result:
+            if re.match(rf"(.+)?{query}(.+)?", impact['name'], re.IGNORECASE):
+                canidates.append(impact['id'])
+
+        return self.utils.resolve_lookup_candidates(canidates)
+
+    def get_id_priority(self, query):
+        result = self.priorities()
+        canidates = list()
+        for priority in result:
+            if re.match(rf"(.+)?{query}(.+)?", priority['name'], re.IGNORECASE):
+                canidates.append(priority['id'])
+
+        return self.utils.resolve_lookup_candidates(canidates)
+
+    def get_id_urgency(self, query):
+        result = self.urgencies()
+        canidates = list()
+        for urgency in result:
+            if re.match(rf"(.+)?{query}(.+)?", urgency['name'], re.IGNORECASE):
+                canidates.append(urgency['id'])
+
+        return self.utils.resolve_lookup_candidates(canidates)
+
+    def get_id_entryType(self, query):
+        result = self.entry_types()
+        canidates = list()
+        for entryType in result:
+            if re.match(rf"(.+)?{query}(.+)?", entryType['name'], re.IGNORECASE):
+                canidates.append(entryType['id'])
+
+        return self.utils.resolve_lookup_candidates(canidates)
+
+    def get_id_callType(self, query):
+        result = self.call_types()
+        canidates = list()
+        for callType in result:
+            if re.match(rf"(.+)?{query}(.+)?", callType['name'], re.IGNORECASE):
+                canidates.append(callType['id'])
+
+        return self.utils.resolve_lookup_candidates(canidates)
+
+    def get_id_duration(self, query):
+        result = self.durations()
+        canidates = list()
+        for callType in result:
+            if re.match(rf"(.+)?{query}(.+)?", callType['name'], re.IGNORECASE):
+                canidates.append(callType['id'])
+
+        return self.utils.resolve_lookup_candidates(canidates)
+    
+    def create(self, caller, **kwargs):
+        # Caller can be: email, uuid or unregisted user. We'll try it in that order.
+        create_body = kwargs
+        create_body['caller'] = caller     
+        return self.utils.handle_topdesk_response(self.utils.post_to_topdesk("/tas/api/incidents/", self.utils.add_id_jsonbody(**create_body)))
+
+    def update(self, incident, **kwargs):
+        if self.utils.is_valid_uuid(incident):
+            return self.utils.handle_topdesk_response(self.utils.put_to_topdesk("/tas/api/incidents/id/{}".format(incident), self.utils.add_id_jsonbody(**kwargs)))
+        else:            
+            return self.utils.handle_topdesk_response(self.utils.put_to_topdesk("/tas/api/incidents/number/{}".format(incident), self.utils.add_id_jsonbody(**kwargs)))
+
+    def archive(self, incident, reason_id=None):
+        if reason_id:
+            param = {'id': reason_id}
+        if self.utils.is_valid_uuid(incident):    
+            return self.utils.handle_topdesk_response(self.utils.put_to_topdesk("/tas/api/incidents/id/{}/archive".format(incident), param))
+        else:
+            return self.utils.handle_topdesk_response(self.utils.put_to_topdesk("/tas/api/incidents/number/{}/archive".format(incident), param))
+
+    def unarchive(self, incident):
+        if self.utils.is_valid_uuid(incident):
+            return self.utils.handle_topdesk_response(self.utils.put_to_topdesk("/tas/api/incidents/id/{}/unarchive".format(incident), None))
+        else:
+            return self.utils.handle_topdesk_response(self.utils.put_to_topdesk("/tas/api/incidents/number/{}/unarchive".format(incident), None))
+
+    def get_list(self, archived=False, page_size=100, query=None, **kwargs):
+        return self.utils.handle_topdesk_response(self.utils.request_topdesk("/tas/api/incidents/", archived, page_size=page_size, query=query, extended_uri=kwargs))