Approve or reject a task awaiting approval

put

https://{env}.gainsystems.com/api/v1/tasks/{taskId}

Approves or rejects your own request while its task is in PendingReview. Nothing is applied until the task is approved.

Approving moves the task to Queued or Received, and it is processed in the next scheduled GAINS run. Rejecting moves it to RejectedNotApproved; nothing is applied and nothing needs to be undone. The decision is final: a task that is no longer in PendingReview is refused with 400, and so is an unknown TaskId. If an approval cannot be handed on to GAINS, the request fails and the task stays in PendingReview, so you can approve it again.

Only POST /api/v1/skus-locations/delete creates tasks that need approval. The approver is taken from your credentials, which must hold the task-approval permission, and is shown on the task as UpdatedBy. The request body carries only the decision and an optional note.

GAINS X version requirement:

Min: 10.0-ER2610

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

*/*

application/json

200The decision was recorded

400Malformed request, unknown field, or failed validation

401Credentials missing or not valid: a wrong user name or password, an invalid or expired token, or Basic credentials on an endpoint that accepts only a Bearer token

403Your credentials do not have the permission this endpoint requires, or the GAINS X connection is not enabled for your environment

426The connected GAINS X version does not support this endpoint. The body states the current version and the version required

500Unexpected server error

503GAINS is temporarily unavailable: GAINS X could not be reached or returned an error, a scheduled GAINS process is running, or your credentials could not be checked. Retry later

504GAINS X did not respond in time. Retry later