Desk

Update Desk List Priority

Set the rep's dial-list order. THE WHOLE ORDER.

This REPLACES the stored order rather than merging into it: sending one id pins that list and unpins every other, and sending [] clears them all. The field name reads like an append, which is exactly why it is said here.

put/desk/list-priority

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/desk/list-priority
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

audience_idsinteger[]

Dial-list (audience) ids, most important first. REPLACES the whole order - an empty list clears every pin.

Response

Successful Response

dataDeskPayload required

An open envelope for one desk object.

Open on purpose - see the module docstring. A rebuilder gets every field the desk returns, including ones added after this contract version.

Changes

No recorded changes to this operation across all 2 revisions of this API.