Desk

Resolve Desk Decision

Resolve a pending card.

snoozed_until is REQUIRED when status=snoozed - it is the fallback timeout even when wake_condition is set, so a snooze can never be indefinite. The app enforces that; this surface does not second-guess it, it forwards the request and lets the single enforcement point answer.

post/desk/decisions/{decision_id}/resolve

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/desk/decisions/{decision_id}/resolve
  • Auth: HTTP bearer

Path parameters

decision_idstring required

Decision id (UUID).

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

statusstring required

approved, edited, skipped, deferred, snoozed or done_already. A status the app does not accept is a 400 rather than being silently dropped, which is why this is an open string and not an enum this surface would have to keep in lock-step. done_already resolves the card AND records the work on its entity.

action_takenobject nullable

Action payload, e.g. the edited email body.

snoozed_untilstring date-time nullable

REQUIRED when status=snoozed. Wake time, UTC.

wake_conditionstring nullable

Early-wake condition, valid only with status=snoozed: reply | site_visit | stage_change. snoozed_until stays required as the fallback timeout. stage_change is accepted but only wakes via that timeout today - no deal-stage-change event reaches the desk signal consumer yet.

Response

Successful Response

dataobject required

Changes

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