# TOPdesk API Documentation

This is the complete API documentation for connecting to the TOPdesk API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **TOPdesk connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/tOPdesk/actions/{actionSlug}/run
```

## TOPdesk actions

- POST `add-incident-time-spent` Add Incident Time Spent
- PUT `archive-incident-by-id` Archive Incident by ID
- POST `create-incident` Create Incident
- PUT `deescalate-incident-by-id` Deescalate Incident by ID
- PUT `escalate-incident-by-id` Escalate Incident by ID
- GET `get-incident-by-id` Get Incident by ID
- GET `get-incident-by-number` Get Incident by Number
- GET `get-incident-progress-trail-count` Get Incident Progress Trail Count
- GET `get-incident-time-spent` Get Incident Time Spent
- GET `list-deescalation-reasons` List Deescalation Reasons
- GET `list-escalation-reasons` List Escalation Reasons
- GET `list-incident-actions` List Incident Actions
- GET `list-incident-call-types` List Incident Call Types
- GET `list-incident-categories` List Incident Categories
- GET `list-incident-priorities` List Incident Priorities
- GET `list-incident-progress-trail` List Incident Progress Trail
- GET `list-incident-requests` List Incident Requests
- GET `list-incident-statuses` List Incident Statuses
- GET `list-incident-subcategories` List Incident Subcategories
- GET `list-incident-urgencies` List Incident Urgencies
- GET `list-incidents` List Incidents
- PUT `replace-incident-by-id` Replace Incident by ID
- PUT `replace-incident-by-number` Replace Incident by Number
- PUT `unarchive-incident-by-id` Unarchive Incident by ID
- PUT `update-incident-by-id-patch` Update Incident by ID (Patch)
- PUT `update-incident-by-number-patch` Update Incident by Number (Patch)