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.

No tools match your search.