v3

latestOpenAPI 3.0.12026-08-0474115357.9 KB

Servicedesk

Add customers

Adds one or more customers to a service desk. If any of the passed customers are associated with the service desk, no changes will be made for those customers and the resource returns a 204 success code.

Permissions required: Service desk administrator

post/rest/servicedeskapi/servicedesk/{serviceDeskId}/customer

Path parameters

serviceDeskIdstring required

The ID of the service desk the customer list should be returned from. This can alternatively be a project identifier.

Request body

accountIdsstring[]

List of users, specified by account IDs, to add to or remove from a service desk.

usernamesstring[]

This property is no longer available and will be removed from the documentation soon. See the deprecation notice for details. Use accountIds instead.

Response

Returned if all the customers were added to the service desk or were already associated with the service desk.