Desk

Update Desk List Goal

Set or clear ONE list's daily dial target.

Unlike /desk/list-priority this is a single-list edit, and a null target CLEARS the goal rather than setting it to zero - a cleared goal stops the counter, a zero would be a goal that is already met.

put/desk/list-goals

Request

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

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

audience_idinteger required

The dial list this target belongs to.

targetinteger nullable

Dials per day. NULL CLEARS the target rather than setting zero.

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.