Decide

POST

/steps/:stepId/decision

POST

/api/v1/steps/:stepId/decision

curl -X POST https://api.taktoria.com/api/v1/steps/stepId/decision \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "status": "NOT_STARTED"
}'

{
  "id": "id",
  "launchId": "launchId",
  "name": "name",
  "functionalTeamId": "functionalTeamId",
  "whenToUse": "EVERY_TIME",
  "status": "NOT_STARTED",
  "sortOrder": 1,
  "createdAt": "2024-01-15T09:30:00Z",
  "updatedAt": "2024-01-15T09:30:00Z",
  "launch": {
    "id": "id",
    "name": "name",
    "status": "SCOPING"
  },
  "templateId": "templateId",
  "functionalTeam": {
    "id": "id",
    "name": "name",
    "slug": "slug"
  },
  "reviewer": {
    "id": "id",
    "name": "name",
    "email": "email",
    "image": "image"
  },
  "reviewerUserId": "reviewerUserId",
  "startDate": "2024-01-15T09:30:00Z",
  "dueDate": "2024-01-15T09:30:00Z",
  "link": "link",
  "notes": "notes",
  "decidedAt": "2024-01-15T09:30:00Z",
  "decisionReason": "decisionReason",
  "lastNudgedAt": "2024-01-15T09:30:00Z"
}

Record a reviewer's decision on a step.

Authentication

AuthorizationBearer

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

Path parameters

stepIdstringRequired

Request

This endpoint expects an object.

statusenumRequired

The approval bit on a single launch step.

notesstringOptional

reasonstringOptional

Why, in up to 1,000 characters. Optional, and only with APPROVED, DENIED, EXCEPTION or NOT_APPLICABLE. It replaces the step’s last reason; a decision without one clears it.

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

linkstringOptional

Link to the supporting doc for this review.

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

422

Validation Error

429

Too Many Requests Error