TOPdesk MCP connector

• List List all TOPdesk incidents List TOPdesk incidents with optional FIQL filtering, field selection, and sorting. Returns: id, number, request, action, briefDescription, caller, operator, operatorGroup, callType, category, subcategory, object, location, callDate, creationDate, modificationDate, targetDate, closedDate, escalationStatus, externalLinks, attachments, partialIncidents, responded, responseDate, sla, departmentId,…
• Create Create a TOPdesk incident Create a new incident in TOPdesk. Returns the created incident including id, number, briefDescription, caller, operator, and operatorGroup. Persons can only set request, briefDescription, callType, category, subcategory, object, location, and operatorGroup.
• Action TOPdesk incidents deescalate Deescalate a TOPdesk incident by id. Returns the updated incident including id, number, briefDescription, caller, operator, and escalationStatus. Required: incident_id.
• Archive TOPdesk incidents archive Archive a TOPdesk incident by id. If the incident has partial incidents they will also be archived. Returns the updated incident including id, number, briefDescription, caller, operator, and escalationStatus. Required: incident_id.
• Action TOPdesk incidents escalate Escalate a TOPdesk incident by id. Returns the updated incident including id, number, briefDescription, caller, operator, and escalationStatus. Required: incident_id.
• Get Get single TOPdesk incident by ID Get a single TOPdesk incident by id. Returns: request, action, caller, operator, operatorGroup, sla. Required: id.
• Update TOPdesk incidents partial update Partially update a TOPdesk incident by id. Returns the updated incident including request, action, caller, operator, and operatorGroup. Required: id.
• Action TOPdesk incidents unarchive Unarchive a TOPdesk incident by incident_id. Returns the unarchived incident including request, action, caller, operator, and operatorGroup. Required: incident_id.
• Update Update a TOPdesk incident by ID Update a TOPdesk incident by id. Returns the updated incident including request, action, caller, operator, and operatorGroup. Required: id.
• Get Get single TOPdesk incident number by ID Get a TOPdesk incident by its incident number. Returns: request, action, caller, operator, operatorGroup. Required: id.
• Update Update a TOPdesk incident number by ID Update a TOPdesk incident by its incident number with a full replacement body. Returns: request, action, caller, operator, operatorGroup. Required: id.
• Update TOPdesk incident numbers partial update Partially update a TOPdesk incident by its incident number. Returns: request, action, caller, operator, operatorGroup. Required: id.
• Archive TOPdesk incident numbers archive Archive a TOPdesk incident by its incident number, optionally providing an archiving reason. Partial incidents are also archived. Returns: request, action, caller, operator, operatorGroup. Required: number_id.
• Action TOPdesk incident numbers escalate Escalate a TOPdesk incident by its incident number, optionally providing an escalation reason. Returns: request, action, caller, operator, operatorGroup. Required: number_id.
• Action TOPdesk incident numbers deescalate Deescalate a TOPdesk incident by its incident number. Returns the updated incident object including request, action, caller, operator, and operatorGroup. Required: number_id. The optional id or name body field supplies a deescalation reason (mandatory when reason is required and no default is set).
• Action TOPdesk incident numbers unarchive Unarchive a TOPdesk incident by its incident number. Returns the incident object including request, action, caller, operator, and operatorGroup. Required: number_id. Partial calls are also unarchived by default; set unarchive_partials to false to keep them archived.
• List TOPdesk incident attachments list by ID List attachments for a TOPdesk incident identified by id. Returns: id, name, type, description, invisibleForCaller. Required: incident_id.
• Upload TOPdesk incident attachments upload by ID Upload a file to a TOPdesk incident identified by id. Returns the uploaded attachment including its id, name, type, description, and invisibleForCaller. Required: incident_id, file.
• List TOPdesk incident attachments list by number List attachments for a TOPdesk incident identified by number. Returns: id, name, type, description, invisibleForCaller. Required: incident_number.
• Upload TOPdesk incident attachments upload by number Upload a file to a TOPdesk incident identified by its incident number. Returns the uploaded attachment object including its id, name, and type. Required: incident_number, file.
• Delete TOPdesk incident attachments delete by ID Delete a file attachment from a TOPdesk incident identified by incident id. Returns an empty response on success. Required: incident_id, attachment_id.
• Delete TOPdesk incident attachments delete by number Delete a file attachment from a TOPdesk incident identified by incident number. Returns an empty 204 response on success. Required: incident_number, attachment_id.
• Download TOPdesk incident attachments download by ID Download a file attachment from a TOPdesk incident identified by incident id. Returns the raw binary file content with a content-type matching the attachment's mime type (e.g. image/png, application/octet-stream). Required: incident_id, attachment_id.
• Download TOPdesk incident attachments download by number Download a file attachment from a TOPdesk incident identified by incident number. Returns the raw binary file content with a content-type matching the attachment's mime type (e.g. image/png, application/octet-stream). Required: incident_number, attachment_id.
• List TOPdesk incident images list by ID List inline images for a TOPdesk incident identified by id. Returns an array of image objects including downloadUrl, filename, originalFileName, fileSize, and invisibleForCaller. Required: incident_id.
• List TOPdesk incident images list by number List inline images for a TOPdesk incident identified by number. Returns an array of image objects including downloadUrl, filename, originalFileName, fileSize, and invisibleForCaller. Required: number_id.
• Get TOPdesk incident images get by ID Retrieve a specific inline image file from a TOPdesk incident identified by id. Returns the raw image file content with the appropriate mime-type (e.g. image/png, or application/octet-stream when the type cannot be determined). Required: incident_id, file_name.
• Get TOPdesk incident images get by number Retrieve a specific inline image file from a TOPdesk incident identified by incident number. Returns the raw image file content with the appropriate mime-type (e.g. image/png, or application/octet-stream when the type cannot be determined). Required: incident_number, file_name.
• List List all TOPdesk requester incidents List TOPdesk requester incidents for SSP users with optional FIQL filtering and field selection. Returns: id, number, request, action, briefDescription, caller, operator, operatorGroup, callType, category, subcategory, object, location, callDate, creationDate, modificationDate, targetDate, closedDate, closed, escalationStatus, externalLinks, attachments, partialIncidents, feedbackRating,…
• Create Create a TOPdesk requester incident Create a first-line incident in TOPdesk for an SSP user. Returns the created incident including id, number, request, briefDescription, caller, and creationDate. Only request, briefDescription, callType, category, subcategory, object, location, and operatorGroup can be set, depending on new call form settings.
• Get Get single TOPdesk requester incident by ID Get a single TOPdesk requester incident by id. Returns: id, number, request, action, briefDescription, caller, operator, operatorGroup, callType, category, subcategory, object, location, callDate, creationDate, modificationDate, targetDate, closedDate, closed, escalationStatus, externalLinks, attachments, partialIncidents, feedbackRating, feedbackMessage, responded, responseDate, sla. Required:…
• Update TOPdesk requester incidents partial update Partially update a TOPdesk requester incident for an SSP user by id. Returns the updated incident including id, number, request, briefDescription, caller, and creationDate. Depending on settings, only action, closed, feedbackRating, and feedbackMessage can be updated. Required: id.
• Get Get single TOPdesk requester incident number by ID Get a single TOPdesk requester incident by incident number. Returns: request, action, caller, operator, operatorGroup, sla. Required: id (the incident number).
• Update TOPdesk requester incident numbers partial update Partially update a TOPdesk requester incident by incident number. Depending on settings, updatable fields include action, closed, feedbackRating, and feedbackMessage. Returns the updated incident including request, action, caller, operator, and operatorGroup. Required: id (the incident number).
• List TOPdesk requester incident attachments list by ID List attachments for a TOPdesk incident identified by id, accessible to SSP (Self Service Portal) users. Returns: id, name, type, description, invisibleForCaller. Required: incident_id.
• Upload TOPdesk requester incident attachments upload by ID Upload a file to a TOPdesk incident identified by id for a SSP user. Returns the uploaded attachment including id, name, type, description, and invisibleForCaller. Required: incident_id, file.
• List TOPdesk requester incident attachments list by number List attachments for a TOPdesk incident identified by number, accessible to SSP (Self Service Portal) users. Returns: id, name, type, description, invisibleForCaller. Required: incident_number.
• Upload TOPdesk requester incident attachments upload by number Upload a file to a TOPdesk incident identified by number for a SSP user. Returns the uploaded attachment including id, name, type, description, and invisibleForCaller. Required: incident_number, file.
• Download TOPdesk requester incident attachments download by ID Download an attachment file from a TOPdesk incident by incident id and attachment id for a SSP user. Returns the file content as a binary stream with a content-type based on the file type. Required: incident_id, attachment_id.
• List TOPdesk requester incident images list by ID List inline images for a TOPdesk incident identified by id, for SSP users. Returns: downloadUrl, filename, originalFileName, fileSize, invisibleForCaller. Required: incident_id.
• List TOPdesk requester incident images list by number List inline images for a TOPdesk incident identified by number, for SSP users. Returns: downloadUrl, filename, originalFileName, fileSize, invisibleForCaller. Required: number_id.
• List List all TOPdesk incident call types List incident call types in TOPdesk. Returns: id, name.
• List TOPdesk incident call types list requester List incident call types for SSP (Self Service Portal) users in TOPdesk. Returns: id, name.
• List List all TOPdesk incident durations List available incident duration options in TOPdesk. Returns: id, name.
• List List all TOPdesk incident entry types List incident entry types in TOPdesk. Returns an array of searchlist objects, each containing id and name.
• List List all TOPdesk incident impacts List all incident impacts (searchlist values) available in TOPdesk. Returns: id, name. No required parameters.
• List List all TOPdesk incident priorities List incident priorities in TOPdesk. Returns: id, name, duration. No required parameters.
• List List all TOPdesk incident statuses List processing statuses for incidents in TOPdesk. Returns an array of status objects, each with id and name. Only unarchived status values are returned. No required parameters.
• List List all TOPdesk incident categories List incident categories in TOPdesk. Returns: id, name.
• List TOPdesk incident categories list requester List incident categories available to SSP (self-service portal) users in TOPdesk. Returns: id, name.
• List List all TOPdesk incident subcategories List incident subcategories in TOPdesk. Returns an array of subcategory objects with id and name. Category, branch, and operator filters may apply depending on operator permissions.
• List TOPdesk incident subcategories list requester List incident subcategories available to SSP (Self Service Portal) users in TOPdesk. Returns: id, name. No required parameters.
• List List all TOPdesk incident closure codes List closure codes in TOPdesk available for closing incidents. Returns: id, name.
• List List all TOPdesk incident urgencies List incident urgencies available in TOPdesk. Returns an array of urgency entries, each with id and name. Category, branch, and operator filters apply.
• List List all TOPdesk incident deescalation reasons List deescalation reasons available for TOPdesk incidents. Returns: id, name. The deescalation feature must be enabled in TOPdesk.
• List List all TOPdesk incident escalation reasons List the available incident escalation reasons in TOPdesk. Returns: id, name. The escalation feature must be enabled on the TOPdesk environment.
• List List all TOPdesk incident slas List SLA services in TOPdesk, filterable by incident, contract, person, branch, service, call type, category, subcategory, asset, and other contract/service criteria. Returns: id. There is no way to request later pages — use more specific filter parameters to narrow results.
• List List all TOPdesk SLA services List SLA services available in TOPdesk for incident SLA configuration. Returns an array of service entries, each containing id and name. No required parameters.
• List TOPdesk incident timespents list by ID Retrieve time spent entries registered on a TOPdesk incident by incident id. Returns: request, action, caller, operator, operatorGroup. Required: incident_id.
• Create TOPdesk incident timespents create by ID Register time spent on a TOPdesk incident by incident id. Returns the created time spent entry including request, action, caller, operator, and operatorGroup. Required: incident_id.
• List TOPdesk incident timespents list by number Retrieve time spent entries registered on a TOPdesk incident by incident number. Returns: request, action, caller, operator, operatorGroup. Required: number.
• Create TOPdesk incident timespents create by number Register time spent on a TOPdesk incident by incident number. Returns the created time spent entry including request, action, caller, operator, and operatorGroup. Required: number.
• List List all TOPdesk incident timeregistrations List TOPdesk incident time registrations. By default only 1st and 2nd line incident entries are returned, and only id is included unless the fields parameter is specified. Returns: id, request, action, caller, operator, operatorGroup, timeSpent, creationDate, modificationDate.
• Get Get single TOPdesk incident timeregistration by ID Get a single TOPdesk incident time registration by id. Returns: id, request, action, caller, operator, operatorGroup, timeSpent, creationDate, modificationDate. Required: id.
• List List all TOPdesk timespent reasons List reasons for time spent in TOPdesk. Returns: id, name. These are simple IdAndName lookup objects used when registering time spent on incidents.
• List TOPdesk incident progresstrails list by ID List TOPdesk incident progress trail entries by incident id. Returns each entry's request, action, caller, operator, and operatorGroup. Required: incident_id. Max 100 entries per page.
• List TOPdesk incident progresstrails list by number List TOPdesk incident progress trail entries by incident number. Returns each entry's request, action, caller, operator, and operatorGroup. Required: number. Max 100 entries per page.
• List TOPdesk incident progresstrails list requester by ID List incident progress trail entries for a TOPdesk incident by incident id. Returns: request, action, caller, operator, operatorGroup. Required: incident_id.
• List TOPdesk incident progresstrails list requester by number List incident progress trail entries for a TOPdesk incident by incident number. Returns: request, action, caller, operator, operatorGroup. Required: number.
• List TOPdesk incident progresstrail counts list by ID Get the progress trail entry count for a TOPdesk incident by incident id (operator endpoint). Returns: count. Required: incident_id.
• List TOPdesk incident progresstrail counts list by number Get the progress trail entry count for a TOPdesk incident by incident number (operator endpoint). Returns: count. Required: number.
• List TOPdesk incident progresstrail counts list requester by ID Get the progress trail entry count for a TOPdesk incident by incident id, accessible by SSP users (persons). Returns: count. Required: incident_id.
• List TOPdesk incident progresstrail counts list requester by number Get the progress trail entry count for a TOPdesk incident by incident number, accessible by SSP users (persons). Returns: count. Required: number.
• List TOPdesk incident actions list by number List incident actions in TOPdesk by incident number. Returns: request, action, caller, operator, operatorGroup. Required: number.
• List TOPdesk incident actions list by ID List incident actions in TOPdesk by incident id. Returns: request, action, caller, operator, operatorGroup. Required: incident_id.
• Get TOPdesk incident actions get by ID Get a single incident action in TOPdesk by incident id and action id. Returns: request, action, caller, operator, operatorGroup. Required: incident_id, action_id.
• Delete TOPdesk incident actions delete by ID Delete an incident action in TOPdesk by incident id and action id. Returns an empty 204 response on success. Required: incident_id, action_id.
• Get TOPdesk incident actions get by number Get a single incident action in TOPdesk by incident number and action id. Returns: request, action, caller, operator, operatorGroup. Required: incident_number, action_id.
• Delete TOPdesk incident actions delete by number Delete an incident action by incident number and action id in TOPdesk. Returns an empty 204 response on success. Required: incident_number, action_id.
• List TOPdesk incident actions list requester by number List incident actions by incident number for SSP users in TOPdesk. Returns: request, action, caller, operator, operatorGroup. Required: number.
• List TOPdesk incident actions list requester by ID List incident actions by incident id for SSP users in TOPdesk. Returns: request, action, caller, operator, operatorGroup. Required: incident_id.
• Get TOPdesk incident actions get requester by ID Get a single incident action by incident id and action id for SSP users in TOPdesk. Returns: request, action, caller, operator, operatorGroup. Required: incident_id, action_id.
• Get TOPdesk incident actions get requester by number Get a single incident action by incident number and action id for SSP users in TOPdesk. Returns: request, action, caller, operator, operatorGroup. Required: incident_number, action_id.
• List TOPdesk incident requests list by number List incident requests for a TOPdesk incident by incident number. Returns: request, action, caller, operator, operatorGroup. Required: number.
• List TOPdesk incident requests list by ID List incident requests for a TOPdesk incident by incident id. Returns: request, action, caller, operator, operatorGroup. Required: incident_id.
• Get TOPdesk incident requests get by ID Get a specific TOPdesk incident request by incident id and request id. Returns: request, action, caller, operator, operatorGroup. Required: incident_id, request_id.
• Delete TOPdesk incident requests delete by ID Delete a TOPdesk incident request by incident id and request id. Returns an empty 204 response on success. Required: incident_id, request_id.
• Get TOPdesk incident requests get by number Get a TOPdesk incident request by incident number and request id. Returns: request, action, caller, operator, operatorGroup. Required: incident_number, request_id.
• Delete TOPdesk incident requests delete by number Delete a TOPdesk incident request by incident number and request id. Returns an empty 204 response on success. Required: incident_number, request_id.
• List TOPdesk incident requests list requester by number List incident requests for a TOPdesk incident identified by number, accessible to SSP (Self-Service Portal) users. Returns: request, action, caller, operator, operatorGroup. Required: number.
• List TOPdesk incident requests list requester by ID List incident requests for a TOPdesk incident identified by id, accessible to SSP (Self-Service Portal) users. Returns: request, action, caller, operator, operatorGroup. Required: incident_id.
• Get TOPdesk incident requests get requester by ID Get a single TOPdesk incident request by incident id and request id, accessible to SSP (Self-Service Portal) users. Returns: request, action, caller, operator, operatorGroup. Required: incident_id, request_id.
• Get TOPdesk incident requests get requester by number Get a single TOPdesk incident request by incident number and request id, accessible to SSP (Self-Service Portal) users. Returns: request, action, caller, operator, operatorGroup. Required: incident_number, request_id.
• List List all TOPdesk login operators Authenticate as a TOPdesk operator and retrieve an authorization token. Deprecated in favor of application passwords. Returns the authorization token as a string.
• List List all TOPdesk login people Generate an authentication token for a person in TOPdesk. Returns the authorization token as a string. No caller-supplied parameters required.
• List List all TOPdesk logouts Log out the current operator or person in TOPdesk. Returns an empty 200 response on success.
• List List all TOPdesk archiving reasons List reasons for archiving in TOPdesk. Returns an array of archiving reason objects, each containing id and name.
• Get Get single TOPdesk emails ID by ID Get details of a TOPdesk email by id for incidents, changes, and change activities. Returns: id, subject, content. Required: id.
• Delete Delete a TOPdesk emails ID by ID Delete a TOPdesk email by id. Returns an empty 204 response on success. Required: id.
• List List all TOPdesk service window lookups List service windows in TOPdesk. This is a lightweight lookup that returns only id and name pairs. Returns: id, name. Filter by name prefix or archived state.
• Get Get single TOPdesk service window lookup by ID Get a single service window in TOPdesk by id. This is a lightweight lookup that returns only id and name. Returns: id, name. Required: id.
• List List all TOPdesk searches Search TOPdesk via the REST API across supported indices. Returns up to 30 search results, each containing id and type. The index parameter selects the search index (currently only incidents).
• List List all TOPdesk versions Get the TOPdesk API version. Returns: version.
• List List all TOPdesk product versions Get the current TOPdesk product version. Returns: major, minor, patch.
• List List all TOPdesk categories List TOPdesk categories and subcategories. Returns each category with id, name, archived, parent, modules, and translations (when requested via fields). No paging is currently supported; translations require fields=translations or fields=all.
• List List all TOPdesk requester categories List requester categories and subcategories in TOPdesk. Returns: id, name, archived, parent, modules, translations. Translations are only returned when explicitly requested via fields=translations or fields=all. Currently no pagination support — all categories are returned at once, though a next-page link may be present if the result set is exceptionally large.
• Get Get single TOPdesk avatars operator by ID Get a TOPdesk operator's avatar by id. Returns the avatar object including the image data and its mime type. Required: id (the operator id, UUID format).
• Get TOPdesk avatars operators get requester Get a TOPdesk operator's avatar for an SSP (Self Service Portal) user by operator id. Returns the avatar object including the image data and its mime type. Required: operator_id.
• Get Get single TOPdesk avatars person by ID Get a TOPdesk person's avatar image by id. Returns the avatar object including its mimeType. Required: id.
• List List all TOPdesk branches List TOPdesk branches with optional FIQL filtering and field selection. Returns the full branch object per item including id, name, specification, branchType, headBranch, address, postalAddress, realEstate, accountManager, contact, attention, serviceWindow, creator, modifier, optionalFields1, optionalFields2, externalLink, archived, status, customerReferenceNumber, VATnumber, creationDate, and…
• Create Create a TOPdesk branch Create a new TOPdesk branch. Returns the created branch including id, name, specification, branchType, headBranch, address, postalAddress, realEstate, accountManager, contact, and other branch details. branchType must be one of independentBranch, headBranch, or hasAHeadBranch; when set to hasAHeadBranch a headBranch must be supplied, and when set to independentBranch no headBranch is allowed.
• Get Get single TOPdesk branch by ID Get a single TOPdesk branch by id. Returns the full branch object including id, name, specification, branchType, headBranch, address, postalAddress, realEstate, accountManager, contact, attention, serviceWindow, creator, modifier, optionalFields1, optionalFields2, externalLink, archived, status, customerReferenceNumber, VATnumber, creationDate, and modificationDate. Required: id.
• Update Update a TOPdesk branch by ID Update a TOPdesk branch by id. Returns the updated branch including id, name, specification, branchType, headBranch, address, postalAddress, realEstate, accountManager, contact, attention, serviceWindow, creator, modifier, optionalFields1, optionalFields2, externalLink, archived, status, customerReferenceNumber, VATnumber, creationDate, and modificationDate. Required: id. When branchType is…
• Update TOPdesk branches partial update Partially update a TOPdesk branch by id. Returns the updated branch including id, name, specification, branchType, headBranch, address, postalAddress, realEstate, accountManager, contact, attention, serviceWindow, creator, modifier, optionalFields1, optionalFields2, externalLink, archived, status, customerReferenceNumber, VATnumber, creationDate, and modificationDate. Required: id. Only fields…
• Archive TOPdesk branches archive Archive a TOPdesk branch by id with an archiving reason. Returns the archived branch including id, name, specification, headBranch, branchType, and archived. Required: branche_id and a body containing the archiving reason id.
• Archive TOPdesk branches archive patch Archive a TOPdesk branch by id with an archiving reason using PATCH. Returns the archived branch including id, name, specification, headBranch, branchType, and archived. Required: branche_id and a body containing the archiving reason id.
• List TOPdesk branches list attachments List attachments for a specific TOPdesk branch identified by its branch id. Returns: id, name, type. Required: branche_id.
• Upload TOPdesk branches upload attachment Upload a file attachment to a TOPdesk branch by branch id. Returns: id, name, type. Required: branche_id, file.
• Delete TOPdesk branches delete attachment Delete an attachment from a TOPdesk branch identified by branche_id. Returns an empty 204 response on success. Required: branche_id, attachment_id.
• Download TOPdesk branches download attachment Download an attachment file from a TOPdesk branch. Returns the attachment as a binary byte stream with the original file's MIME type. Required: branche_id, attachment_id. Branch filters apply for operator access.
• List List all TOPdesk branches building levels List building level values configured in TOPdesk. Returns: id, name.
• List List all TOPdesk branches designations List branch designation values in TOPdesk. Returns an array of searchlist entries, each containing id and name. No required parameters.
• List List all TOPdesk branches energy performances List all energy performance values available for branches in TOPdesk. Returns: id, name.
• List List all TOPdesk branches environmental impacts List environmental impact values available for branches in TOPdesk. Returns: id, name.
• List List all TOPdesk branches listed buildings List listed building values available for branches in TOPdesk. Returns: id, name.
• List List all TOPdesk branches lookups List TOPdesk branch lookup entries (lightweight id and name pairs) sorted by ascending name. Returns: id, name. Filter by name prefix or archived status.
• Get Get single TOPdesk branches lookup by ID Get a single TOPdesk branch lookup entry (a lightweight id and name pair) by id. Returns: id, name. Required: id.
• List List all TOPdesk budgetholders List TOPdesk budget holders, optionally filtered by external link. Returns: id, name, externalLink. The external_link_id and external_link_type filters should be used in combination with each other.
• Create Create a TOPdesk budgetholder Create a new budget holder in TOPdesk. Returns the created budget holder including id, name, and externalLink. Required: name.
• Update Update a TOPdesk budgetholder by ID Update the name of a TOPdesk budget holder by id. Returns the updated budget holder including id, name, and externalLink. Required: id.
• Delete Delete a TOPdesk budgetholder by ID Delete a TOPdesk budget holder by id. Returns an empty 204 response on success. Required: id.
• Archive TOPdesk budgetholders archive Archive a TOPdesk budget holder by id. Returns the archived budget holder including id, name, and externalLink. Required: budgetholder_id.
• List List all TOPdesk countries List all countries stored in TOPdesk. Returns: id, name for each country entry.
• List List all TOPdesk departments List departments in TOPdesk, optionally filtered by external link. Returns: id, name, externalLink. The external_link_id and external_link_type filters should be used in combination.
• Create Create a TOPdesk department Create a department in TOPdesk. Returns: id. Required: name. The name must be unique and not exceed the maximum length.
• Update Update a TOPdesk department by ID Update the name of a department in TOPdesk by id. Returns: id, name, external_link. Required: id, name.
• Delete Delete a TOPdesk department by ID Delete a TOPdesk department by id. Returns an empty 204 response on success. Required: id. The delete fails with a 409 if the department is still referenced by other cards.
• Archive TOPdesk departments archive Archive a department in TOPdesk by its identifier. Returns the archived department object including its id, name, and external_link. Required: department_id.
• List List all TOPdesk languages List languages configured in TOPdesk. Returns: id, name.
• List List all TOPdesk locations List TOPdesk locations with optional FIQL filtering and field selection. Returns: id, name, type. Use the $fields parameter to control which fields are included.
• Create Create a TOPdesk location Create a new TOPdesk location. Returns the created location including id, name, roomNumber, branch, and roomSetup. Accepts name (max 100 chars), branch, roomSetup (standardLocation, divisibleLocation, or isASubLocation), majorLocation, and reservationManagement settings.
• Get Get single TOPdesk location by ID Get a single TOPdesk location by id. Returns the full location object including id, name, roomNumber, branch, roomSetup, capacity, and reservationManagement settings. Required: id.
• Update Update a TOPdesk location by ID Update a TOPdesk location by id with full field replacement. Returns the updated location including id, name, roomNumber, branch, and roomSetup. Required: id.
• Update TOPdesk locations partial update Partially update a TOPdesk location by id, changing only the provided fields. Returns the updated location including id, name, roomNumber, branch, and roomSetup. Required: id.
• Archive TOPdesk locations archive Archive a TOPdesk location by id with an archiving reason. Returns the full archived location object including id, name, roomNumber, branch, roomSetup, archived, and status. Required: location_id. An archiving reason (id or name) must be supplied in the body when no default reason is configured.
• Archive TOPdesk locations archive patch Archive a TOPdesk location by id with an archiving reason using the PATCH method. Returns the full archived location object including id, name, roomNumber, branch, roomSetup, archived, and status. Required: location_id. An archiving reason (id or name) must be supplied in the body when no default reason is configured.
• List List all TOPdesk locations building zones List building zones in TOPdesk. Returns: id, name.
• List List all TOPdesk locations ceiling coverings List ceiling covering values in TOPdesk supporting files. Returns an array of searchlist entries, each with id and name. Category/Branch/Operator filters apply for operator access.
• List List all TOPdesk locations floor coverings List floor covering values configured in TOPdesk supporting files. Returns: id, name, archived. Operator access only; Category/Branch/Operator filters apply.
• List List all TOPdesk locations functional uses List functional uses for locations in TOPdesk. Returns an array of searchlist entries including id, name, archived, and order.
• List List all TOPdesk locations glass materials List glass materials in TOPdesk. Returns an array of glass material searchlist values, each with id and name.
• List List all TOPdesk locations lookups List TOPdesk location lookup entries (id and name pairs) sorted by ascending name. Returns: id, name. Filter by name prefix or archived status; use $all to return all entries ignoring $top.
• Get Get single TOPdesk locations lookup by ID Get a single TOPdesk location lookup entry by id. Returns: id, name. Required: id.
• List List all TOPdesk locations statuses List room (location) statuses in TOPdesk. Returns an array of searchlist entries with id and name for each room status value. Category/Branch/Operator filters apply for operator access.
• List List all TOPdesk locations types List all location types configured in TOPdesk. Returns: id, name. Category/Branch/Operator filters apply for operators.
• List List all TOPdesk locations wall coverings List wall coverings in TOPdesk. Returns each wall covering entry with its id and name.
• List List all TOPdesk operatorgroups List TOPdesk operator groups with optional FIQL filtering and field selection. Returns: id, name. Max 100 per page.
• Create Create a TOPdesk operatorgroup Create a TOPdesk operator group. Returns the created operator group including id, name, groupName, branch, location, budgetHolder, contact, accessRoles, archived, stockManager. Required: name (max 50 characters).
• List TOPdesk operatorgroups list by operator List operator groups linked to a specific TOPdesk operator. Returns: id, name. Required: operator_id. Supports FIQL filtering on the archived status of linked operator groups.
• Create TOPdesk operatorgroups create by operator Link operator groups to a TOPdesk operator by providing their UUIDs. Returns an empty 204 response on success. Required: operator_id.
• Delete TOPdesk operatorgroups delete by operator Unlink operator groups from a TOPdesk operator by providing their UUIDs. Returns an empty 204 response on success. Required: operator_id.
• Get Get single TOPdesk operatorgroup by ID Get a TOPdesk operator group by id. Returns the full operator group object including id, groupName, branch, contact, accessRoles, archived, and stockManager. Required: id.
• Update Update a TOPdesk operatorgroup by ID Update a TOPdesk operator group by id with a full replacement of all writable fields. Returns the updated operator group including id, groupName, branch, contact, accessRoles, archived, and stockManager. Required: id.
• Update TOPdesk operatorgroups partial update Partially update a TOPdesk operator group by id, changing only the supplied fields. Returns the updated operator group including id, groupName, branch, contact, accessRoles, archived, and stockManager. Required: id.
• Archive TOPdesk operatorgroups archive Archive a TOPdesk operator group by id. Returns the archived operator group including id, groupName, branch, accessRoles, and archived. Required: operatorgroup_id and a request body containing the archiving reason id.
• Archive TOPdesk operatorgroups archive patch Archive an operator group in TOPdesk by providing an archiving reason. Returns the archived operator group object including id, groupName, branch, contact, and accessRoles. Required: operatorgroup_id, id (archiving reason id in the body). Reason for archiving is mandatory and must reference a valid archiving reason retrievable via the archiving-reasons endpoint.
• List List all TOPdesk operatorgroups lookups List TOPdesk operator group id and name pairs, sorted by ascending name. Returns: id, name. Filter by name prefix, archived status, role, or operatorid.
• Get Get single TOPdesk operatorgroups lookup by ID Get a single TOPdesk operator group id and name pair by id. Returns: id, name. Required: id.
• List List all TOPdesk operators List TOPdesk operators with optional FIQL query filtering and field selection. Returns: id. When the query parameter is not used, only active (non-archived) operators are returned.
• List TOPdesk operators list by operatorgroup List operators belonging to a specific TOPdesk operator group. Returns: id, name. Required: operatorgroup_id.
• Create Create a TOPdesk operator Create a new TOPdesk operator with basic fields, linkedPerson, and optional login credentials. Returns: id. If loginPermission is set to true, loginName and password must be provided; loginName must be unique.
• Get TOPdesk operators get current Get the currently logged-in TOPdesk operator. Returns: id, surName, branch, archived, accessRoles, hasApplicationPasswords, operatorGroup, language, location, department, budgetHolder, attention, creator, modifier, optionalFields1, optionalFields2, externalLink, linkedPerson. The accessRoles and hasApplicationPasswords fields may be excluded depending on the caller's permissions.
• Get TOPdesk operators get current ID Get the id of the currently logged-in operator in TOPdesk. Returns: id. No parameters required.
• Get Get single TOPdesk operator by ID Get a single TOPdesk operator by id. Returns the operator object including id, surName, branch, loginName, and archived. Required: id.
• Update Update a TOPdesk operator by ID Update a TOPdesk operator by id with a full replacement of all settable fields. Returns the updated operator including id, surName, branch, loginName, and archived. The linkedPerson field cannot be changed on an existing operator. Required: id.
• Update TOPdesk operators partial update Partially update a TOPdesk operator by id, changing only the provided fields. Returns the updated operator including id, surName, branch, loginName, and archived. The linkedPerson field cannot be changed on an existing operator. Required: id.
• Archive TOPdesk operators archive Archive a TOPdesk operator by id with an archiving reason. Returns the archived operator including id, surName, branch, and archived. Cannot archive yourself or administrators. Required: operator_id, id (archiving reason in request body).
• Archive TOPdesk operators archive patch Archive a TOPdesk operator using PATCH by id with an archiving reason. Returns the archived operator including id, surName, branch, and archived. Cannot archive yourself or administrators. Required: operator_id, id (archiving reason in request body).
• List List all TOPdesk operators lookups List TOPdesk operator id and name pairs, sorted by ascending name. Returns: id, name. Filter by name prefix, archived status, role, operator group, or whether to include service principals.
• Get Get single TOPdesk operators lookup by ID Get a single TOPdesk operator's id and name pair by id. Returns: id, name. Required: id.
• List List all TOPdesk operators settings Get the logged-in TOPdesk operator's personal settings. Returns the operator settings object (OperatorSettingsDto) with operator-specific configuration fields whose shape is defined upstream in the TOPdesk OpenAPI schema; consult the upstream API documentation for the full field-level breakdown.
• List List all TOPdesk filters branches List all branch filters available in TOPdesk. Returns: id, name.
• List TOPdesk filters branches list by operator List branch filters linked to a specific TOPdesk operator. Returns: id, name. Required: operator_id.
• Create Create a TOPdesk filters branch Link branch filters to a TOPdesk operator by providing an array of filter UUIDs in the request body. Returns an empty 204 response on success. Required: operator_id, and a request body array of objects each with an id (branch filter UUID). Non-existent ids, filters applying to all operators, and already-linked filters are ignored.
• Delete TOPdesk filters branches bulk delete Unlink branch filters from a TOPdesk operator by providing an array of filter UUIDs in the request body. Returns an empty 204 response on success. Required: operator_id, and a request body array of objects each with an id (branch filter UUID). Non-existent ids, filters applying to all operators, and already-unlinked filters are ignored.
• List List all TOPdesk filters categories List all category filters available in TOPdesk. Returns: id.
• List TOPdesk filters categories list by operator List the category filters linked to a specific TOPdesk operator. Returns: id. Required: operator_id.
• Create Create a TOPdesk filters category Link category filters to an operator in TOPdesk by providing a list of filter UUIDs. Returns an empty 204 response on success. Required: operator_id.
• Delete TOPdesk filters categories bulk delete Unlink category filters from an operator in TOPdesk by providing a list of filter UUIDs. Returns an empty 204 response on success. Required: operator_id.
• List List all TOPdesk filters operators List all operator filters available in TOPdesk. Returns an array of filter objects, each with id and name.
• List TOPdesk filters operators list by operator List the operator filters linked to a specific TOPdesk operator. Returns an array of filter objects, each with id and name. Required: operator_id.
• Create Create a TOPdesk filters operator Link operator filters to a TOPdesk operator by providing an array of filter UUIDs. Non-existent ids, filters applying to all operators, or filters already linked are ignored. Returns an empty 204 response on success. Required: operator_id.
• Delete TOPdesk filters operators bulk delete Unlink operator filters from a TOPdesk operator by providing an array of filter UUIDs. Non-existent ids, filters applying to all operators, or unlinked filters are ignored. Returns an empty 204 response on success. Required: operator_id.
• List List all TOPdesk permissiongroups List permission groups in TOPdesk. Returns an array of permission group entries including id and name.
• List TOPdesk permissiongroups list by operator List the permission groups linked to a specific TOPdesk operator. Returns: id, name. Required: operator_id.
• Create TOPdesk permissiongroups create by operator Link permission groups to a TOPdesk operator by passing a list of permission group UUIDs in the request body. Returns an empty 204 response on success. Required: operator_id.
• Delete TOPdesk permissiongroups delete by operator Unlink permission groups from a TOPdesk operator by passing a list of permission group UUIDs in the request body. Returns an empty 204 response on success. Required: operator_id.
• List List all TOPdesk people List TOPdesk persons with optional FIQL filtering, field selection, and sorting. Returns person records including id, firstName, surName, dynamicName, email, phoneNumber, mobileNumber, jobTitle, department, branch, location, archived, and loginName. The V2 endpoint returns a limited field set by default; use the fields parameter to request additional fields. Max 5000 per page.
• Create Create a TOPdesk person Create a new TOPdesk person. Returns the created person object including id, firstName, surName, dynamicName, email, branch, and department. Defaults hasSspAccess and isCaller to true when omitted. The department field accepts an id (drop-down list mode) or a name (plain text field mode) depending on settings.
• Get TOPdesk people get current Get the currently logged-in TOPdesk person (SSP user). Returns: id, firstName, surName, dynamicName, email, phoneNumber, mobileNumber, fax, city, jobTitle, employeeNumber, loginName, networkLoginName, privateMobileNumber, isManager, hasSspAccess, isCaller, archived, gender, showBranch, showSubsidiaries, authorizeBranch, authorizeSubsidiaryBranches, creationDate, modificationDate, department,…
• Get Get single TOPdesk person by ID Get a single person in TOPdesk by id. Returns the full person object including id, firstName, surName, dynamicName, email, phoneNumber, mobileNumber, fax, jobTitle, department, city, branch, location, and archived. Required: id.
• Update TOPdesk people partial update Partially update a TOPdesk person by id (v2). Returns the updated person including id, firstName, surName, dynamicName, email, branch, department, and language. Required: id. The 'department' field varies based on user settings — use an object with 'id' for a drop-down list or 'name' for a plain text field. This v2 endpoint is not backward compatible with the previous version.
• Archive TOPdesk people archive Archive a person and its linked operator (if any) in TOPdesk. Returns the archived person object including id, firstName, surName, and email. Required: person_id. An archiving reason must be supplied in the request body.
• Archive TOPdesk people archive patch Archive a person (and its linked operator if one exists) in TOPdesk by providing an archiving reason. Returns the archived person object including id, firstName, surName, email, archived, and archivingReason. Required: person_id. The archiving reason body may be omitted if a default archiving reason is configured; if omitted and no default exists, the request fails.
• List List all TOPdesk persons counts Get the total number of persons in TOPdesk, optionally filtered by a FIQL search expression. Returns: count.
• List TOPdesk persons counts list requester Get the total number of active persons for SSP users in TOPdesk — only counts persons marked as callers (requesters) that are not archived. Returns: count. Archived persons are never returned.
• List List all TOPdesk person persongroups List person groups that a TOPdesk person is a member of. Returns: id, name, archived. Required: person_id.
• List List all TOPdesk avatars Get a person's avatar in TOPdesk by person id. Returns: image, mimeType. Required: id.
• List List all TOPdesk person contracts Get a person's contract in TOPdesk. Returns: personId, contractInformation (including contractHours). Required: person_id. This endpoint version is not backward compatible with the previous contract endpoint version.
• Update TOPdesk person contracts bulk update Update a person's contract in TOPdesk. Returns: personId, contractInformation (including contractHours). Required: id. This endpoint version is not backward compatible with the previous contract endpoint version.
• List List all TOPdesk person private details Get a person's private details in TOPdesk. Returns: personId, address (including address.city). Required: person_id. This endpoint version is not backward compatible with the previous privateDetails endpoint.
• Update TOPdesk person private details bulk update Update a person's private details in TOPdesk. Returns: personId, address (including address.city). Required: id. This endpoint version is not backward compatible with the previous privateDetails endpoint.
• List List all TOPdesk persons lookups List TOPdesk person id and name pairs sorted by ascending name, with optional filtering by name prefix, archived status, and caller status. Returns: id, name.
• Get Get single TOPdesk persons lookup by ID Get a single TOPdesk person lookup entry by id, returning a lightweight id and name pair. Returns: id, name. Required: id.
• List List all TOPdesk person extra field a entries List non-archived person extra field A entries in TOPdesk. Returns each entry including its id and name. Optional filters: external_link_id (use with external_link_type), external_link_type (use with external_link_id).
• Create Create a TOPdesk person extra field a entry Create a person extra field A entry in TOPdesk. Returns the created entry including id, name, and externalLink (id, type, date). Required: name. The name must be unique among person extra field A entries.
• List List all TOPdesk person extra field b entries List non-archived person extra field B entries in TOPdesk. Returns each entry's id, name, and externalLink.
• Create Create a TOPdesk person extra field b entry Create a person extra field B entry in TOPdesk. Returns the created entry including its id, name, and externalLink. Required: name.
• List List all TOPdesk persongroups List TOPdesk person groups with FIQL filtering, sorting, and field selection. Returns: id, name. Without a query filter, all person groups including archived are returned.
• Create Create a TOPdesk persongroup Create a new TOPdesk person group. Returns the created person group including id, name, archived, and branch. Required: name.
• Get Get single TOPdesk persongroup by ID Get a single TOPdesk person group by id. Returns: id, name. Required: id.
• Update TOPdesk persongroups partial update Update a TOPdesk person group by id. Returns the updated person group including id, name, archived, and branch. Required: id.
• Archive TOPdesk persongroups archive Archive a TOPdesk person group by id. Returns: id, name. Required: persongroup_id. If the request body is omitted, a default archiving reason is applied when available.
• Action TOPdesk persongroups unarchive Unarchive a person group in TOPdesk by its id. Returns the person group's id, name, archived state, and archiving reason. Required: persongroup_id.
• List List all TOPdesk persongroup people List persons belonging to a specific person group in TOPdesk. Returns: id. Required: persongroup_id. Supports FIQL filtering via the query parameter and field selection via the fields parameter.
• List List all TOPdesk persongroups lookups List TOPdesk person group id and name pairs, sorted by ascending name. Returns: id, name. Enabling $all bypasses page size and may degrade system performance.
• Get Get single TOPdesk persongroups lookup by ID Get a single TOPdesk person group id and name pair by id. Returns: id, name. Required: id.
• Create Create a TOPdesk picture Upload an image to TOPdesk. Returns the UUID id of the uploaded picture. Required: file.
• Get Get single TOPdesk picture by ID Get a picture from TOPdesk by id, returned as a binary bytestream. The size parameter selects full or thumbnail. Required: id.
• List List all TOPdesk supplier contacts List TOPdesk supplier contacts, optionally filtered by a FIQL search expression. Returns: id. When no query is provided, only active supplier contacts are returned.
• Get Get single TOPdesk supplier contact by ID Get a single TOPdesk supplier contact by id. Returns: id. Required: id.
• List List all TOPdesk suppliers List TOPdesk suppliers with optional FIQL filtering. Returns each supplier with id, name, forFirstLine, forSecondLine, forService, forOperationalActivity, forChangeManagement, archived, mainContact, visitorAddress, postalAddress, and externalLink. Max 100 per page.
• Get Get single TOPdesk supplier by ID Get a single TOPdesk supplier by id. Returns the supplier object including id, name, forFirstLine, forSecondLine, forService, forOperationalActivity, forChangeManagement, archived, mainContact, visitorAddress, postalAddress, and externalLink. Required: id.
• List List all TOPdesk suppliers lookups List TOPdesk suppliers as lightweight id and name lookup pairs, sorted by ascending name. Returns: id, name. Filter by name prefix or archived status; use $all to retrieve all entries at once (may impact performance).
• Get Get single TOPdesk suppliers lookup by ID Get a single TOPdesk supplier as a lightweight lookup entry by id, returning only the supplier's id and name pair. Returns: id, name. Required: id.
• List List all TOPdesk requester branches List branches available to SSP users in TOPdesk. Returns: id, name, archived. When no FIQL query is provided, only active branches are returned; using the query parameter returns both archived and non-archived branches.
• List List all TOPdesk requester locations List TOPdesk requester locations available to SSP users. Returns: id, name. When no FIQL query filter is supplied, only active locations are returned by default.
• List List all TOPdesk requester people List active TOPdesk requester persons (callers only) for SSP users. Archived persons are never returned. Returns: id. Use the fields parameter to select specific fields.
• Get Get single TOPdesk requester person by ID Get a single TOPdesk requester person by id for SSP users. Only returns the person when marked as a caller and active (not archived). Returns: id. Required: id. Use the fields parameter to select specific fields.
• List TOPdesk free field searchlists list incidents List optional drop-down values for a free-field searchlist on incidents in TOPdesk. Returns: id, name. Required: tab, searchlist.
• List TOPdesk free field searchlists list branches List optional drop-down values for a free-field searchlist on branches in TOPdesk, optionally filtered by external link. Returns: id, name, externalLink. Required: tab, searchlist.
• List TOPdesk free field searchlists list locations List optional drop-down values for a TOPdesk location free-field searchlist. Returns each entry's id, name, and externalLink (containing id, type, date). Required: tab (1 or 2), searchlist (1–5).
• List TOPdesk free field searchlists list operators List optional free-field drop-down values for operators in TOPdesk. Returns each entry's id, name, and externalLink. Required: tab (1 or 2), searchlist (1–5).
• Create TOPdesk free field searchlists create operators Create an optional operator drop-down list entry in TOPdesk for a specific free-fields tab and searchlist. Returns: id, name, externalLink. Required: tab, searchlist, name. The tab must be 1 or 2; the searchlist must be between 1 and 5. Entry names must be unique within the searchlist.
• List TOPdesk free field searchlists list persons List optional drop-down values for a person free-field searchlist in TOPdesk. Returns an array of entries including id, name, order, archived status, and external link details. Required: tab (1 or 2), searchlist (1-5).
• Create TOPdesk free field searchlists create persons Create an optional person free-field drop-down list entry in TOPdesk. Returns the created entry including its id, name, and externalLink. Required: tab (must be 1 or 2), searchlist (must be 1–5), and a request body containing the entry name.
• List List all TOPdesk assets List TOPdesk assets with extensive filtering by template, status, linked entities, and OData expressions. Returns: id, name, etag, state, type, icon. Additional fields can be requested via the fields parameter.
• Create Create a TOPdesk asset Create a new TOPdesk asset. Returns: id. Required: type_id plus all mandatory template-specific fields.
• Get Get single TOPdesk asset by ID Get a single TOPdesk asset by id. Returns: id, name. Required: id.
• Update Update a TOPdesk asset by ID Update an existing TOPdesk asset by id with modified field values. Returns: id, name. Required: id.
• Archive TOPdesk assets archive Archive a TOPdesk asset by providing a reason for archiving. Returns: id, name. Required: asset_id, reasonId.
• Get TOPdesk assets get grid field values Get the asset values stored in a grid widget field of a TOPdesk asset. Returns the grid asset structure response including id and schema-specific attribute fields. Required: assetId, fieldId. The v1 media type is deprecated; use the v2 Accept header.
• Get Get single TOPdesk assets template ID by ID List all TOPdesk assets of a given type by template ID. By default only active assets are returned, each with its id; additional fields can be requested via the field parameter. Returns: id, name, type. Required: id (template ID).
• Create Create a TOPdesk assets template ID Create a new TOPdesk asset by template ID. The request body maps field IDs to desired values. Returns: id, name, type. Required: template_id and a request body.
• Update Update a TOPdesk assets template ID by ID Update an existing TOPdesk asset by mapping field IDs to new values. Returns: id. Required: template_id, id. Only specified fields are updated; null clears a value (required fields cannot be cleared). Updating an archived asset unarchives it.
• Archive TOPdesk assets template IDS archive Archive a TOPdesk asset with a reason for archiving. Returns an empty 204 response on success. Required: template_id, asset_id, reasonId. If already archived, nothing happens.
• List List all TOPdesk asset assignments List TOPdesk asset assignments for a specific asset, including assigned locations, branches, persons, and person groups. Returns: linkId, linkType, linkToId, branchId, inheritanceParentId. Required: asset_id.
• Delete Delete a TOPdesk asset assignment by ID Remove an assigned branch, location, person, or person group from a TOPdesk asset by assignment link id. Returns an empty 200 response on success. Required: asset_id, id.
• Update TOPdesk asset assignments bulk update Add a branch, location, person, or person group assignment to a single TOPdesk asset, stock, or bulk item. Returns: linkId, linkType, linkToId, branchId, inheritanceParentId. Required: asset_id, linkType, linkToId.
• List List all TOPdesk asset actions List available actions (manual triggers) for a TOPdesk asset. Returns the manual triggers response object describing the actions that can be executed on the asset. Required: asset_id (UUID of the asset).
• Create Create a TOPdesk asset copy Copy an active TOPdesk asset to create one or more duplicate assets. Returns a list of created asset copies, each including an id. Required: asset_id, numberOfCopies. Only available for active assets; when auto numbering is disabled on the source asset's template, prefix and startAt are also mandatory in the request body.
• Create Create a TOPdesk asset unarchive Unarchive a TOPdesk asset by its id, restoring it from an archived state. Returns the unarchived asset object including its id, name, creationDate, and modificationDate. Required: asset_id.
• List List all TOPdesk history current items List current external links to a TOPdesk asset as history items. Returns: id, type, next. Required: asset_id.
• List List all TOPdesk history past items List past history items from the audit log for a specific TOPdesk asset, optionally including events from external sources. Returns: id, type. Required: asset_id.
• List List all TOPdesk assets blanks Retrieve a blank, not-yet-persisted TOPdesk asset card for a specific template, showing all card fields and their properties including which are mandatory. Returns the blank asset object with id and template-specific field attributes. At least one of templateId or templateName must be provided; if both are given they must reference the same template. templateName only matches templates with a…
• Delete Delete a TOPdesk assets delete by ID Delete several TOPdesk assets in bulk by providing a list of asset IDs. Returns: failed (asset IDs that could not be deleted due to existing links from other components). Required: assetIds. Assets that cannot be deleted do not prevent deletion of the remaining assets.
• Get Get single TOPdesk assets filter by ID Search TOPdesk assets by submitting filter criteria in the request body, accepting the same parameters as the GET /assets endpoint but in JSON form to support complex multi-parameter filters. Returns matching asset records including id, name, modificationDate, and creationDate. Default page size is 50 entries.
• List List all TOPdesk assets grid field assets Retrieve a single grid field asset row in TOPdesk identified by its asset ID and the host asset it belongs to. Returns: id. Required: assetId, hostAssetId.
• Update Update a TOPdesk assets grid field asset by ID Update an existing grid field asset row in TOPdesk by providing modified field values as key-value pairs. Returns: id. A 202 response indicates some unknown fields in the request were ignored. Required: assetId, hostAssetId.
• Delete Delete a TOPdesk assets delete grid field asset by ID Delete a row from a grid widget on a TOPdesk host asset and update the host asset. Returns: id. Required: assetId, hostAssetId.
• Create Create a TOPdesk assets unlink Delete links between a specified entity and one or more assets in TOPdesk. Returns an UnlinkResponse object confirming the deletion result. Required: type, target_id, and a body containing assetIds.
• Create Create a TOPdesk assets linked knowledge item Create links between a TOPdesk knowledge item and one or more assets in a single request. Returns a BulkLinkResponse indicating the results of the linking operation. Linking archived knowledge items is supported. Requires a request body specifying the knowledge item and the target assets. Maximum 50 assets per request.
• Create Create a TOPdesk assets linked service Link a service to one or more assets in TOPdesk's Asset Management module. Returns: id, name. Archived assets or services cannot be linked.
• Create Create a TOPdesk assets linked task Create links between a TOPdesk task (change, change activity, incident, operational activity, operational series, or problem) and one or more assets in a single request. Returns a bulk link response. Maximum 50 assets per request; linking archived assets or archived tasks is not allowed. Requires a request body specifying the task and asset identifiers.
• Update TOPdesk assets assignments bulk update Add branch, location, person and person group assignments to multiple assets, stocks or bulk items in TOPdesk. Returns: links. Required: assetIds, linkType, linkToId. Maximum 50 asset IDs per request.
• List List all TOPdesk asset links List TOPdesk asset links (relationships) for a given source asset. Returns: id, name, type. When both sourceId and targetId are provided, the direction of the link is also matched. Required: sourceId.
• Create Create a TOPdesk asset link Create a link (relationship) between two TOPdesk assets. Returns: id, name, type. Required: sourceId, targetId. Use the possibleRelations endpoint to discover available relationship types before creating a link.
• Delete Delete a TOPdesk asset link by ID Remove a link between two TOPdesk assets by relation id. Returns: id, name, type. Required: id.
• List List all TOPdesk asset links possible relations List the possible relationship types between two TOPDESK assets. Returns an array of available link type ID strings (child, parent, and other link types). Required: sourceId, targetId. Returns an empty array if both assets are already linked in every possible way.
• List List all TOPdesk asset statuses List all asset statuses in TOPdesk. By default only the ID of each status is returned; pass field=name to also include the translated display name. Returns: id, name. The field query parameter only accepts the value "name"; any other value returns a 400 error.
• List List all TOPdesk capabilities List all link types (capabilities) in TOPdesk Asset Management. Returns: id, name, archived.
• Create Create a TOPdesk capability Create a new link type (capability) in TOPdesk Asset Management. Returns: id. Required: name. The name must be non-empty, not too long, and unique among all link types.
• Get TOPdesk capabilities get by ID Get a specific TOPdesk capability (link type) by its id. Returns: id, name, usage. Required: capability_id.
• Update Update a TOPdesk capability by ID Update the name or inheritance status of an existing TOPdesk link type (capability). Returns: id, name. Required: id. A 400 is returned if the new name is empty, too long, or already used by another link type; a 409 indicates concurrent modification.
• Delete Delete a TOPdesk capability by ID Delete a TOPdesk capability (link type) by id. Built-in link types and types currently used in relations cannot be deleted. Returns an empty 204 response on success. Required: id.
• Archive TOPdesk capabilities archive Archive a TOPdesk capability (link type) by its id. Returns the archived capability object including its id and name. Required: capability_id. Returns 400 if the link type is already archived.
• Create Create a TOPdesk capabilitie unarchive Unarchive a TOPdesk capability (link type) by its id, restoring a previously archived link type to active status. Returns the unarchived capability object including its id and name. Required: capability_id. Returns a 400 if the link type isn't currently archived.
• List List all TOPdesk card types List all active asset templates (card types) in TOPdesk. Returns: name, id, fields, and operations for each template. Only active templates are returned.
• Get Get single TOPdesk dropdown by ID Get all options for a TOPdesk dropdown in Asset Management by id. Returns a list of dropdown option objects, each with id and optionally name (include name via field=name). Required: id.
• Search TOPdesk dropdowns get query Retrieve or create a dropdown option in TOPdesk Asset Management. If an option with the given name already exists (case-insensitive), its id is returned and archived options are unarchived; otherwise a new option is created. Returns: id. Required: dropdown_id, name. Name must not be null, blank, or exceed 60 characters.
• List List all TOPdesk fields List TOPdesk asset management fields with optional filtering by display name, template, or resource category. Returns: id, name. Fields can be filtered by searchTerm, resourceCategory, templateId, excludedTemplateId, includeFromVisibleTemplatesOnly, and includeInUse.
• Get Get single TOPdesk field by ID Get a single TOPdesk asset management field definition by id. Returns: id, name. Required: id.
• Delete Delete a TOPdesk field by ID Delete a TOPdesk asset management field permanently by id. This also removes all recorded data and removes the field from templates, summary fields, data set widgets, and saved overview filters. Returns an empty response on success. Required: id.
• List List all TOPdesk import assets List all non-archived assets in TOPdesk. Returns: id, name. By default only the asset ID is included; use the 'field' query parameter to request additional fields — only 'name' and 'id' are supported. To retrieve other fields, use the API for querying assets of a specific type instead.
• List List all TOPdesk stock quantities List stock quantities in TOPdesk by stock or bulk item. When using stockId, returns all bulk items linked to that stock with their quantities; when using bulkItemId, returns all stocks linked to that bulk item with their quantities. Returns: id, name, quantity. Exactly one of stockId or bulkItemId must be provided; providing both or neither returns an error.
• Create Create a TOPdesk stock quantity Link a bulk item to a stock in TOPdesk with a specified initial quantity. Returns: id. Required: stockId, bulkItemId, quantity.
• Update Update a TOPdesk stock quantity by ID Update the quantity of a bulk item on a stock in TOPdesk by relationship id. Returns: id, name, quantity. Required: id, quantity. An If-Match header with the current ETag is required.
• Delete Delete a TOPdesk stock quantity by ID Remove the link between a bulk item and a stock in TOPdesk by relationship id. Returns an empty 204 response on success. Required: id.
• List List all TOPdesk stock totals List stock statistics in TOPdesk showing which asset types and bulk items are in stock, how many stocks each appears in, instance counts for asset types, and total quantities for bulk items. Returns: attributes. Archived items are always included; items without read permission or excluded by branch filters are omitted.
• List List all TOPdesk templates List TOPdesk asset management templates (asset types). Returns each template's id and name. Template IDs are needed when creating new assets or filtering assets by type.
• List List all TOPdesk uploads List uploaded file blobs attached to a TOPdesk asset. Returns: id. Required: assetId.
• Create Create a TOPdesk upload Upload one or more file blobs to a TOPdesk asset using multipart form data. Returns: id. Required: assetId, file.
• Delete Delete a TOPdesk upload by ID Delete an uploaded file blob from TOPdesk by id. Returns an empty 204 response on success. Required: id.
• Import TOPdesk import links children bulk update Set the children of a TOPdesk asset by providing a list of asset IDs representing the desired child links; assets not yet linked are linked and those no longer listed are unlinked. Returns a LinkResults object listing any errors encountered during (un)linking. Required: asset_id. Only available for active assets with a relationships widget; response code is 200 even when individual link…
• Update Update a TOPdesk import links incoming by ID Set an asset's incoming dependency links by link type in TOPdesk. The body is a list of asset or stock UUIDs representing the desired state — new entries are assigned, absent ones unlinked. Returns: errors. Required: asset_id, id. Response is 200 even when individual linking errors occur; an asset cannot be linked to itself.
• Update Update a TOPdesk import links outgoing by ID Set an asset's outgoing (provided) links by link type in TOPdesk. The body is a list of asset IDs representing the desired state; assets not in the list are unlinked. Returns: errors. Required: asset_id, id (link_type_id). Only available for active assets with a relationships widget providing the specified link type; an asset cannot be linked to itself.
• Import TOPdesk import links parents bulk update Set the parent links of a TOPdesk asset by providing the desired list of parent asset IDs — new IDs are linked and previously linked parents not in the list are unlinked. Returns: linked, unlinked, errors. Required: asset_id. Only available for active assets with a relationships widget; an asset cannot be linked to itself or to an asset it already directly or indirectly parents.
• Update TOPdesk assignment branches bulk update Assign branches to a TOPdesk asset by submitting a list of branch IDs that represents the desired state of branch assignments. Returns the link results, with any errors encountered during (un)assignment listed in the response body. Required: template_id, asset_id. Only available for active assets with an assignment widget.
• Update TOPdesk assignment locations bulk update Assign locations to a TOPdesk asset with a list of location IDs representing the desired state; locations not in the list are unassigned. Returns the link results including any errors that occurred during (un)assignment. Required: template_id, asset_id. Only available for active assets with an assignment widget; the response code is still 200 when errors occur.
• Update TOPdesk assignment person groups bulk update Set the desired state of person group assignments for a TOPdesk asset. Returns: errors encountered during (un)assignment. Required: template_id, asset_id, and a body listing person group IDs. Only available for active assets with an assignment widget; the response is always 200 even when errors occur.
• Update TOPdesk assignment people bulk update Assign persons to a TOPdesk asset by submitting the desired list of person IDs. The supplied list represents the desired state — persons in the list but not yet assigned will be assigned, and persons assigned but absent from the list will be unassigned. Returns: errors (any errors encountered during assignment are listed in the response body, and the HTTP status remains 200 even when errors…
• List List all TOPdesk services List TOPdesk services sorted alphabetically, optionally filtered by a linked object. Returns: id, name. Archived services are not included. objectId and assetId are mutually exclusive and cannot be combined in the same query.
• Create Create a TOPdesk service Create a non-reservable TOPdesk service with the provided name. Returns the created service including its id and name. Required: name.
• Get Get single TOPdesk service by ID Get a single TOPdesk service by its id. Returns the service details including id and name. Required: id.
• List List all TOPdesk service linked assets List TOPdesk assets linked to a service. Returns: id, assetId, name. Required: service_id.
• Create Create a TOPdesk service linked asset Link one or more assets to a TOPdesk service by their id or assetId. Returns the updated list of linked assets for the service. Required: service_id. Cannot link an asset if either the service or asset is archived, or if the asset is already linked to the service.
• Update Update a TOPdesk service linked asset by ID Update properties of a link between an asset and a service in TOPdesk. Returns an empty 204 response on success. Required: service_id, id. The link cannot be updated if either or both cards are archived.
• Delete Delete a TOPdesk service linked asset by ID Unlink an asset from a service in TOPdesk. Returns an empty 204 response on success. Required: service_id, id. The asset cannot be unlinked if either or both cards are archived.
• List List all TOPdesk operational activities List TOPdesk operational activities, returning both archived and non-archived items by default. Returns: id, number, creationDate, modificationDate, plannedStartDate, plannedEndDate, estimatedCosts, estimatedTime, request, action, operator, operatorGroup, status, type, category, subcategory, supplier, schema, grouping, series, creator, modifier, caller, searchlist, skipped, anomaly, archived,…
• Create Create a TOPdesk operational activity Create a new TOPdesk operational activity. Returns the created activity with id, number, operator, operatorGroup, status, type, and other fields. Fields like type, category, subcategory, operator, operatorGroup, supplier, status, and searchlist can be set by UUID or name. Required: briefDescription, plannedStartDate, plannedEndDate.
• Get Get single TOPdesk operational activity by ID Get a single TOPdesk operational activity by id or number. Returns: id, type, schema. Required: identifier.
• Update Update a TOPdesk operational activity by ID Update an existing operational activity in TOPdesk using the deprecated POST endpoint — prefer partial_update (PATCH) where possible. Only send fields that need updating; sending null clears optional fields or causes a Bad Request for mandatory ones. operator and operatorGroup must be sent together. Returns an empty 204 response on success. Required: identifier.
• List TOPdesk operational activities list attachments List attachments for a TOPdesk operational activity, sorted by entry date descending. Returns: id, name, type. Inline images are not returned. Required: identifier.
• Update TOPdesk operational activities bulk update Partially update an existing operational activity in TOPdesk using merge-patch semantics. Only send fields that need updating; sending null clears their value. Co-dependent field pairs must be sent together: operator with operatorGroup, category with subcategory, grouping with schema. Returns an empty 204 response on success. Required: identifier.
• List List all TOPdesk operational activities settings Get operational activities settings in TOPdesk. Returns a settings object indicating which fields that can be set as mandatory on operational activities are currently mandatory. No caller-supplied parameters are required.
• List List all TOPdesk linked objects List linked configuration management objects of a TOPdesk operational activity by identifier. Returns: id, name. This endpoint only returns configuration management objects, not linked assets. Required: identifier.
• Create Create a TOPdesk linked asset Link one or more assets to an operational activity in TOPdesk by sending an array of assets, each identified by either id or name (not both). Archived assets cannot be linked. Returns an empty 201 response on success. Required: identifier.
• List List all TOPdesk linked locations List linked locations of a TOPdesk operational activity, returning an array of IdAndName objects with id and name for each location. This endpoint is deprecated; use the operational activity details endpoint with accept-header application/x.topdesk-om-activity-v1+json instead. Returns: id, name. Required: identifier.
• Create Create a TOPdesk linked location Link one or more locations to a TOPdesk operational activity. Each location is specified by either id or name; archived locations cannot be linked. Returns an empty 201 response on success. Required: identifier.
• List List all TOPdesk linked branches List branches linked to a TOPdesk operational activity. Returns each linked branch's id and name. This endpoint is deprecated; use the operational activity details endpoint with the appropriate accept header instead. Required: identifier.
• Create Create a TOPdesk linked branch Link one or more branches to a TOPdesk operational activity. Each branch is specified by either id or name. Returns an empty 201 Created response on success. Archived branches cannot be linked. Required: identifier.
• List List all TOPdesk time registrations List time registrations for a TOPdesk operational activity, sorted by entry date descending and creation date ascending. Returns: id. Required: identifier.
• Create Create a TOPdesk time registration Register time spent on a TOPdesk operational activity by submitting a JSON request body based on the timeRegistrationCreate schema. Returns an empty 200 response on success. Required: identifier.
• Create Create a TOPdesk attachments upload Upload a file attachment to a TOPdesk operational activity identified by its id. Returns: id, name, type. Suitable for adding files only, not links. Required: identifier.
• List List all TOPdesk operational activity emails List emails of a TOPdesk operational activity. Emails are sorted by send date descending; archived emails are not returned. Returns: id, subject, actionName. Required: identifier.
• Get Get single TOPdesk operational activity email by ID Get a single email from a TOPdesk operational activity by id. Archived emails are also returned by this endpoint. Returns: id, subject, content. Required: id, identifier.
• List List all TOPdesk operational activities statuses List non-archived operational activity statuses in TOPdesk. Returns: id, name. Only non-archived statuses are returned.
• List List all TOPdesk operational activities reasons for skippings List non-archived reasons for skipping for operational activities in TOPdesk. Returns: id, name. Only non-archived entries are returned.
• List List all TOPdesk operational activities reasons for anomalies List non-archived reasons for anomaly for operational activities in TOPdesk. Returns: id, name.
• List List all TOPdesk operational activities types List operational activity types in TOPdesk, optionally filtered by a FIQL search expression. Returns: id, name.
• List List all TOPdesk operational series Get a single TOPdesk operational series by identifier. Returns the series object including id, briefDescription, and number. Required: identifier.
• List List all TOPdesk operational activities schemas List operational activity schemas in TOPdesk. Returns: id, name. Items are sorted by name:asc by default and can be filtered with a FIQL expression via the query parameter or narrowed with the fields parameter.
• List List all TOPdesk operational activities groupings List groupings for operational activities in TOPdesk. Returns: id, name. Supports FIQL filtering, field selection, and sorting. Default sort is name ascending.
• Delete Delete a TOPdesk operational activity attachment by ID Delete a file attachment from an operational activity in TOPdesk. Returns an empty 204 response on success. Required: identifier, id.
• Download TOPdesk operational activity attachments download Download a file attachment from an operational activity in TOPdesk. Returns the raw file content as a binary stream with Content-Disposition and Content-Length headers; suitable for retrieving files but not links. Required: identifier, attachment_id.
• List List all TOPdesk reservations List TOPdesk reservations. Returns each reservation with id, number, requester, operator, operatorGroup, processingStatus, recurrencySeriesId, modificationDate, and briefDescription.
• Create Create a TOPdesk reservation Create a new TOPdesk reservation, specifying the requester and optional details such as operator, operatorGroup, and processingStatus. Returns the created reservation including id, number, requester, operator, operatorGroup, processingStatus, recurrencySeriesId, modificationDate, and briefDescription.
• Get Get single TOPdesk reservation by ID Get a single TOPdesk reservation by identifier (id or reservation number). Returns: id, number, requester, operator, operatorGroup, processingStatus, recurrencySeriesId, modificationDate, briefDescription. Required: identifier.
• Approve TOPdesk reservations approve Approve a TOPdesk reservation by identifier, triggering the approval workflow for the reservation. Returns: id, number, operator, operatorGroup, processingStatus, modificationDate, plannedStartDate, participants, reservedFacilities, recurrencySeriesId. Required: identifier.
• Cancel TOPdesk reservations cancel Cancel a TOPdesk reservation by identifier. Returns the updated reservation including id, number, operator, operatorGroup, and processingStatus. Required: identifier.
• Reject TOPdesk reservations reject Reject a TOPdesk reservation by identifier. Returns the updated reservation including id, number, operator, operatorGroup, and processingStatus. Required: identifier.
• Action TOPdesk reservations reschedule Reschedule a TOPdesk reservation by identifier. Returns the updated reservation including id, number, operator, operatorGroup, and processingStatus. Required: identifier.
• List TOPdesk reservations list attachments List attachments for a TOPdesk reservation by identifier. Returns each attachment with id, name, and type. Required: identifier.
• Upload TOPdesk reservations upload attachment Upload a file attachment to a TOPdesk reservation by identifier. Returns the created attachment object including its id, name, and type. Required: identifier, file.
• Update TOPdesk reservations bulk update Partially update a TOPdesk reservation by identifier — send only the fields that need to be updated; fields with empty or null values will clear their value. Returns: id, number, operator, operatorGroup, processingStatus, modificationDate, plannedStartDate, participants, reservedFacilities, recurrencySeriesId. Required: identifier.
• List List all TOPdesk reservations numbers Get a TOPdesk reservation by its reservation number. Deprecated; use /reservations/{identifier} instead, which also accepts the number. Returns: id. Required: number.
• Update TOPdesk reservations numbers bulk update Partially update a TOPdesk reservation by its number. Deprecated; use /reservations/{identifier} instead. Status, plannedStart/EndDate, and reservedFacilities require dedicated endpoints. Setting requester updates related person fields; only one external link can be set. Returns: id, number, status, archived, briefDescription, notes, numberOfPersons, plannedStartDate, plannedEndDate,…
• Create Create a TOPdesk requester reservation Create a reservation for an SSP (Self Service Portal) user in TOPdesk. Returns: id. Required: requester (must be set to the SSP user's own person-id). SSP users can only reserve assets; setting requester auto-populates related person fields.
• Create Create a TOPdesk make recurrent date Make a TOPdesk reservation recurrent on specific dates. Returns a list of all reservations in the new series including id, number, status, series, plannedStartDate, and plannedEndDate. Required: identifier, dates. Dates must be unique ISO 8601 date-only strings (yyyy-MM-dd) after the original reservation; the series cannot exceed 999 total occurrences.
• Create Create a TOPdesk occurrences date Add occurrences to a recurrent TOPdesk reservation series using the specific-dates pattern. Returns a list of all reservations in the new series including id, number, status, series, plannedStartDate, and plannedEndDate. Required: identifier, dates. Dates must be unique ISO 8601 date-only strings (yyyy-MM-dd) after the specified reservation; the series cannot exceed 999 occurrences total.
• Update TOPdesk occurrences dates bulk update Set occurrences for a recurrent TOPdesk reservation series using the specific-dates pattern, keeping occurrences before the specified reservation and deleting those after it if not included. Returns a list of all reservations in the new series including id, number, status, series, plannedStartDate, and plannedEndDate. Required: identifier, dates. Dates must be unique ISO 8601 date-only strings…
• Create Create a TOPdesk participants add Add participants to a TOPdesk reservation. Already-linked participants are silently ignored. Returns the updated reservation including id, reservationNumber, briefDescription, startDate, endDate, and status. Required: identifier.
• Create Create a TOPdesk participants remove Remove participants from a TOPdesk reservation. Participants not already linked are silently ignored. Returns the updated reservation including id, number, status, briefDescription, plannedStartDate, plannedEndDate, and participants. Required: identifier.
• Create Create a TOPdesk reserved facilities add Add reserved facilities to a reservation in TOPdesk. Returns the updated reservation including id, briefDescription, startDate, endDate, and status. Required: identifier and a request body specifying the facilities to add. Only planned or requested reservations and conflicts can have facilities changed; archived, cancelled, rejected, or recurring-series occurrences with issued facilities cannot…
• Create Create a TOPdesk reserved facilities move Reschedule a reserved facility in a TOPdesk reservation, replacing one facility with another. Returns the updated reservation including id, briefDescription, and reservedFacilities. Required: identifier (the reservation id or number). Only planned or requested reservations and conflicts are eligible; archived, cancelled, or rejected reservations, reservations with issued facilities, and…
• Create Create a TOPdesk reserved facilities remove Remove reserved facilities from a TOPdesk reservation. Returns the updated reservation including id, number, status, briefDescription, plannedStartDate, plannedEndDate, and reservedFacilities. Required: identifier. Only planned, requested, or conflicting reservations can be modified; archived, cancelled, or rejected reservations, reservations with issued facilities, and occurrences of recurring…
• Create Create a TOPdesk reservation reserved service Add and remove services for a reserved facility on a TOPdesk reservation. Returns the updated reservation including id, number, briefDescription, status, startDate, endDate, and reservedFacilities. Required: identifier. Added services are reserved with default values from the service card; for removal, use the reserved service id from reservation.reservedFacilities.reservedServices.id, not the…
• List List all TOPdesk reservations optional searchlists List optional searchlist entries for a given tab and searchlist number in TOPdesk reservations management. Returns: id, name. Required: tab, searchlist.
• Create Create a TOPdesk reservations optional searchlist Create a new optional searchlist entry for TOPdesk reservations management. Returns the created entry including id and name. Required: tab, searchlist, name.
• Archive TOPdesk reservations optional searchlists archive Archive an optional searchlist entry for reservations management in TOPdesk. Returns the archived entry including its id, name, external_link_id, and external_link_type. Required: tab, searchlist, identifier.
• Update TOPdesk reservations optional searchlists bulk update Update the name or external link of an optional searchlist entry for reservations management in TOPdesk. Returns the updated entry including its id, name, external_link_id, and external_link_type. Required: tab, searchlist, identifier.
• List List all TOPdesk reservation cancellation reasons List TOPdesk reservation cancellation reasons for planned reservations. Returns: id, name, archived. The archived query parameter defaults to false and does not allow null/unspecified.
• Create Create a TOPdesk reservation cancellation reason Create a new TOPdesk reservation cancellation reason for planned reservations. Returns: id, name, archived. Required: name.
• Archive TOPdesk reservation cancellation reasons archive Archive a TOPdesk reservation cancellation reason for planned reservations. Returns: id, name, archived. Required: identifier.
• Action TOPdesk reservation cancellation reasons unarchive Unarchive a TOPdesk reservation cancellation reason for planned reservations. Returns: id, name, archived. Required: identifier.
• Update TOPdesk reservation cancellation reasons bulk update Update the name of a TOPdesk reservation cancellation reason for planned reservations. Returns: id, name, archived. Required: identifier, name.
• List List all TOPdesk reservation processing status List reservation processing statuses in TOPdesk. Returns: id, name, archived. Use the optional archived parameter to filter for archived or active entries only.
• Create Create a TOPdesk reservation processing status Create a processing status option for reservations and requests in TOPdesk. Returns the created searchlist entry including its id, name, and archived flag. Required: name.
• Archive TOPdesk reservation processing status archive Archive a reservation processing status in TOPdesk. Returns the archived searchlist entry including its id, name, and archived status. Required: identifier.
• Action TOPdesk reservation processing status unarchive Unarchive a reservation processing status in TOPdesk. Returns the unarchived searchlist entry including its id, name, and archived status. Required: identifier.
• Update TOPdesk reservation processing status bulk update Update the name of a reservation processing status option for reservations and requests in TOPdesk. Returns the updated processing status entry including its id and name. Required: identifier.
• List List all TOPdesk reservation rejection reasons List reservation rejection reasons in TOPdesk. Returns each rejection reason with its id, name, and archived status. The archived parameter defaults to false, showing only active entries by default.
• Create Create a TOPdesk reservation rejection reason Create a rejection reason for reservation requests in TOPdesk. Returns the created searchlist entry with its id and name. Required: name.
• Archive TOPdesk reservation rejection reasons archive Archive a TOPdesk reservation rejection reason by its identifier or name. Returns the updated searchlist entry including its id and name. Required: identifier.
• Action TOPdesk reservation rejection reasons unarchive Unarchive a TOPdesk reservation rejection reason by its identifier or name. Returns the updated searchlist entry including its id, name, and archived status. Required: identifier.
• Update TOPdesk reservation rejection reasons bulk update Update the name of a reservation rejection reason in TOPdesk. Returns the updated rejection reason including its id and name. Required: identifier.
• List List all TOPdesk service types List service types in TOPdesk, optionally filtering by archived status. Returns each entry with id and name. Omit the archived parameter to return both active and archived entries.
• Create Create a TOPdesk service type Create a service type in TOPdesk. Returns the created service type with id, name, and archived. Required: name.
• Archive TOPdesk service types archive Archive a service type in TOPdesk by its identifier or name. Returns the archived service type with id and name. Required: identifier.
• Action TOPdesk service types unarchive Unarchive a service type in TOPdesk by its identifier or name. Returns the unarchived service type with id, name, and archived. Required: identifier.
• Update TOPdesk service types bulk update Update a service type in TOPdesk by its identifier or name. Returns the updated service type with id and name. Required: identifier, name.
• List List all TOPdesk visitors List TOPdesk visitors with RSQL filtering and field selection. Returns: id, archived, visitor, visit, host. Use the query parameter for RSQL filtering (e.g. archived==false, visit.arrivalStatus==expected) and the fields parameter to select specific response fields.
• Create Create a TOPdesk visitor Create a new visitor in TOPdesk. Returns the created visitor object including id, archived, visitor, visit, and host. The POST /visitors endpoint is not documented in the source; refer to the TOPdesk Visitor Registration API documentation for available request fields.
• Get Get single TOPdesk visitor by ID Get a single TOPdesk visitor by identifier. Returns: id, archived, visitor, visit, host. The visit section includes arrivalStatus. Required: identifier.
• Archive TOPdesk visitors archive Archive a visitor in TOPdesk by identifier. Optionally supply an archiving reason in the request body; if omitted, the default archiving reason is applied when available. Returns: id, name, archived. Required: identifier.
• List TOPdesk visitors list attachments List file attachments for a TOPdesk visitor by identifier. Returns: id, name, type, description, entryDate, mimeType. Required: identifier.
• Upload TOPdesk visitors upload attachment Upload a file attachment to a TOPdesk visitor. Returns the created attachment including id, name, type, description, entryDate, and mimeType. Required: identifier, file.
• Update TOPdesk visitors bulk update Partially update a TOPdesk visitor by identifier. Returns the updated visitor including id, visitor (name, phoneNumber), host, visit (arrivalStatus, expectedArrival), and archived. Required: identifier.
• Delete Delete a TOPdesk visitor attachment by ID Delete an attachment from a TOPdesk visitor. Returns an empty 204 response on success. Required: identifier, id. Only available for operators; SSP users should use the delete_requester method instead.
• Delete TOPdesk visitor attachments delete requester Delete an attachment from a TOPdesk visitor for SSP users. Returns an empty 204 response on success. Required: identifier, attachment_id. Only available when SSP users can view visitors; not available for operators.
• Create Create a TOPdesk visitor unarchive Unarchive a TOPdesk visitor by its id or number. Returns an empty 204 response on success. Required: identifier.
• List List all TOPdesk requester visitors List visitors in TOPdesk via the requester (SSP) endpoint, an alternative for GET /visitors. Returns: identifier, archived, visitor, visit, host. Supports FIQL query filtering (e.g. by archived status, visitor phone number, or host branch) and field selection via the fields parameter.
• Get Get single TOPdesk requester visitor by ID Get a single visitor in TOPdesk by identifier via the requester (SSP) endpoint. Returns: identifier, archived, visitor, visit, host. Required: identifier.
• List TOPdesk requester visitors list attachments List attachments for a TOPdesk visitor by identifier. Returns each attachment's id, name, and type. Required: identifier.
• Upload TOPdesk requester visitors upload attachment Upload a file attachment to a TOPdesk visitor registration identified by identifier. Returns the uploaded attachment object including id, name, and type. Required: identifier, file.
• Update TOPdesk requester visitors bulk update Partially update a visitor in TOPdesk by identifier via the requester (SSP) endpoint, an alternative for PATCH /visitors/{identifier}. Returns the updated visitor object including identifier, archived, visitor, visit, host. Required: identifier.
• List List all TOPdesk badges List TOPdesk badges, optionally filtering by archived status. Returns: id, name.
• Create Create a TOPdesk badge Create a new TOPdesk badge. Returns: id, name. Required: name.
• Archive TOPdesk badges archive Archive a TOPdesk badge by id or name. Returns an empty 204 response on success. Required: identifier.
• Update TOPdesk badges bulk update Update a TOPdesk badge by id or name. Returns an empty 204 response on success. Required: identifier.
• Create Create a TOPdesk badge unarchive Unarchive a TOPdesk badge by its id or name. Returns an empty 204 response on success. Required: identifier.
• List List all TOPdesk car parks List car parks available in TOPdesk's Visitor Registration module. Returns: id, number, request, action, briefDescription, changeType, caller, operator, operatorGroup, requester, template.
• Create Create a TOPdesk car park Create a new car park in TOPdesk's visitor management module. Returns the created car park record including its id and resource-specific attributes. Accepts a JSON request body with car park properties as defined in the TOPdesk Visitors API explorer.
• Archive TOPdesk car parks archive Archive a car park in TOPdesk by its identifier. Returns the archived car park object including its id, name, and archived state. Required: identifier.
• Action TOPdesk car parks unarchive Unarchive a car park in TOPdesk by its identifier. Returns the unarchived car park object including its id. Required: identifier.
• Update TOPdesk car parks bulk update Update a car park in TOPdesk by its identifier. Returns: id. Required: identifier. Send the fields to update as a JSON body; consult the TOPdesk Visitor Registration API documentation for the full list of updatable car park fields.
• List List all TOPdesk identification types List identification types in TOPdesk for visitor registration. Returns: id, name, archived.
• Create Create a TOPdesk identification type Create a new identification type in TOPdesk for visitor registration. Returns: id, name, archived. Required: name.
• Archive TOPdesk identification types archive Archive an identification type in TOPdesk, marking it as no longer active. Returns: id, name, archived. Required: identifier.
• Action TOPdesk identification types unarchive Unarchive an identification type in TOPdesk, making it active again. Returns: id, name, archived. Required: identifier.
• Update TOPdesk identification types bulk update Update an existing identification type in TOPdesk. Returns: id, name, archived. Required: identifier.
• List List all TOPdesk visitor optional searchlists List TOPdesk visitor optional searchlist (drop-down) entries for a given tab and searchlist number. Returns: id, name, external_link. Required: tab, searchlist.
• Create Create a TOPdesk visitor optional searchlist Create a new TOPdesk visitor optional searchlist (drop-down) entry. Returns: id, name, external_link. Required: tab, searchlist, name.
• Archive TOPdesk visitor optional searchlists archive Archive a TOPdesk visitor optional searchlist (drop-down) entry by identifier. Returns: id, name, external_link. Required: tab, searchlist, identifier.
• Action TOPdesk visitor optional searchlists unarchive Unarchive a TOPdesk visitor optional searchlist (drop-down) entry by identifier. Returns: id, name, external_link. Required: tab, searchlist, identifier.
• Update TOPdesk visitor optional searchlists bulk update Update a TOPdesk visitor optional searchlist (drop-down) entry by identifier. Returns: id, name, external_link. Required: tab, searchlist, identifier.
• List List all TOPdesk facility occupancies List facility occupancies from TOPdesk's Reservations API. Returns a collection of occupancy records, each with an id and facility-specific attributes whose shape depends on the upstream schema.
• List List all TOPdesk overview reservations List overview reservations in TOPdesk. Returns: id, operator, operatorGroup, processingStatus.
• Get Get single TOPdesk overview reservation by ID Get a single overview reservation in TOPdesk by id. Returns: id, operator, operatorGroup, processingStatus. Required: id.
• List List all TOPdesk overview reservations numbers Retrieve a reservation overview from TOPdesk by its reservation number. Returns reservation overview details. Required: number.
• List List all TOPdesk reservable assets List reservable assets in TOPdesk for a given time period and asset template. Returns: id, name, branches, location. The endpoint calculates availability based on service windows and block time.
• List TOPdesk reservable intervals list by asset List reservable intervals for a specific reservable asset in TOPdesk. Returns the time intervals during which the asset is available for reservation. Required: identifier.
• List TOPdesk reservable intervals list by location Get the reservable interval for a specific TOPdesk reservable location, representing the period starting from a given date/time in which the location is still reservable. The returned date/time format can be used for the plannedFrom and plannedTo parameters of the /api/reservations endpoints. Returns: start, end. Required: reservablelocation_id.
• List List all TOPdesk reservable locations List reservable locations in TOPdesk that are available for booking via the Reservations Management API. Returns: id, name, roomNumber, branch, capacity. Supports FIQL query filtering and field selection via $fields. When no query filter is used, only active (non-archived) locations are returned by default.
• Get Get single TOPdesk reservable location by ID Get a single reservable location in TOPdesk by id. Returns: id. Required: id.
• List List all TOPdesk reservable services List reservable services available in TOPdesk's Reservations Management API. Returns: id, name.
• Get Get single TOPdesk reservable service by ID Get a specific reservable service by id in TOPdesk. Returns: id, name. Required: id.
• List List all TOPdesk currencies Get the TOPdesk currency settings. Returns the currency configuration object with currency details used across TOPdesk modules.
• List List all TOPdesk optionalfield fields Retrieve the names of enabled optional fields for a specified TOPdesk database table and field type. Returns a map of optional field identifiers to their display names (e.g., vrijedatum1 → 'Birthday', vrijedatum2 → 'Start Date', vrijetekst1 → 'Job Title'). Required: table, type.
• Create Create a TOPdesk tasknotifications custom Create a custom task notification in TOPdesk sent to specified operators and operator groups. Returns an empty 201 response on success. Required: title. At least one of operatorIds or operatorGroupIds must be provided; if url is supplied it must start with '/tas/secure/'.
• Create Create a TOPdesk public Create a record in TOPdesk via the public API endpoint, supporting incident-style payloads (request, action, caller, operator, operatorGroup) or change-style payloads (requester, briefDescription, template). Returns: id, number, requester, briefDescription, changeType.

No tools match your search.