Skip to navigation
API ReferenceSteps

Set Reason

Give, change or take away the reason on a step already decided (APPROVED, DENIED, EXCEPTION or NOT_APPLICABLE), leaving the decision as it is: the app’s Add a reason and Edit the reason. A reason given goes in the launch’s activity (reasoned); nobody is notified again. A step that has no decision is 409 not_decided. Needs steps:write.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

stepIdstringRequired

Request

This endpoint expects an object.
reasonstringOptional

Why it was decided as it was, in up to 1,000 characters; null or an empty string takes the reason away. Required: send null rather than leaving it out.

Response

This endpoint returns an object.
idstring
launchIdstring
namestring
functionalTeamIdstring
whenToUseenum
How required a step is, from its launch template.
Allowed values:
statusenum
The approval bit on a single launch step.
sortOrderinteger
createdAtdatetime
updatedAtdatetime
launchobjectOptional
templateIdstringOptional
functionalTeamobjectOptional
A functional team, the group that performs one kind of review.
reviewerobjectOptional
A person in a Taktoria organization.
reviewerUserIdstringOptional

Who reviews it, a member of the workspace; anybody else is a 422 naming the field.

startDatedatetimeOptional
dueDatedatetimeOptional
notesstringOptional
decidedAtdatetimeOptional
decisionReasonstringOptional

Why the reviewer decided as they did, as they wrote it. Only a decided step (APPROVED, DENIED, EXCEPTION or NOT_APPLICABLE) has one; a new decision replaces it.

lastNudgedAtdatetimeOptional

Errors

403
Forbidden Error
404
Not Found Error
409
Conflict Error
422
Validation Error
429
Too Many Requests Error