Skip to main content
POST
Read the approval step an emailed decision link is for: what it asks, who asked, and which of approve, forward, send…

Headers

Prefer
enum<string>

Preference

Available options:
params=single-object

Body

Read the approval step an emailed decision link is for: what it asks, who asked, and which of approve, forward, send back for revision, roll back and reject may be pressed now — of the verbs the caller names in p_verbs (APPROVE, FORWARD, REVISE, SEND_BACK, REJECT), which a caller that names none is given APPROVE, SEND_BACK and REJECT of. Where FORWARD is offered, forward_candidates lists who it may be forwarded to as [{id, label}]. state is OPEN, USED, SETTLED, or FORWARDED where the person the link is for has handed their place on the step to forwarded_to. display_status is the request's status as every screen shows it (PENDING, ROLLBACK, REVISION, APPROVED, REJECTED, WITHDRAWN or FAILED), and initiator is who a revision goes to. Called without a session; the token from the email is the credential. Decides nothing. An unknown, expired or mistyped token is refused with one message whichever it was.

p_token
string<text>
required
p_verbs
string[]

Response

200

OK