/mcp200: Success 400: Bad Request 400: Finesse API error (for example, the object does not exist, the object is stale, or violation of DB constraint) 401: Authorization Failure 401: Invalid Authorization User Specified 500: Internal Server Error HTTP Response: <MediaPropertiesLayouts> <MediaPropertiesLayout> ... Full MediaPropertiesLayout Object ... </MediaPropertiesLayout> <MediaPropertiesLayout> ... Full MediaPropertiesLayout Object ... </MediaPropertiesLayout> <MediaPropertiesLayout> ... Full MediaPropertiesLayout Object ... </MediaPropertiesLayout> </MediaPropertiesLayouts> Example Response: <ApiErrors> <ApiError> <ErrorType>Authorization Failure</ErrorType> <ErrorMessage>UNAUTHORIZED</ErrorMessage> <ErrorData>1234</ErrorData> </ApiError> </ApiErrors> Example Failure Response: User—Get List of Phone Books This API allows a user to get a list of phone books and the first list of associated contacts for that user, based on the defined range (1 to 6000). Contacts are retrieved from the global phone books first, followed by the team phone books, up to the maximum limit of 6000. Cisco Finesse Release 12.5(1) onward, this API is deprecated. For more information about the PhoneBook object, see PhoneBook, on page 271. https://<FQDN>/finesse/api/User/<id>/PhoneBooks URI: https://finesse1.xyz.com/finesse/api/User/1234/PhoneBooks Example URI: Agents and supervisors can use this API. Any user can get a list of their own phone books if they are signed in or they provide valid authorization credentials when challenged. Security Constraints: "Range: objects=1-6000" The range of contacts to retrieve. Additional Headers: GET HTTP Method: — Content Type: Cisco Finesse Web Services Developer and JavaScript Guide, Release 12.5(1) 61 Cisco Finesse Desktop APIs User—Get List of Phone Books