As a contractor, I should be able to update the details of a milestone stage, so that I can update it's approval status or criteria and extend the date if needed

[arafaysaleem]

Summary

As a contractor, I should be able to update the details of a milestone stage, so that I can update it's approval status or criteria and extend the date if needed.

Acceptance Criteria

GIVEN a contractor is editing a milestone stage in the desktop app
WHEN the app hits the milestone-stages/:id endpoint with a valid PATCH request, containing:-
The path parameter:

• :id, the unique id of the milestone stage which is being edited.

And any of the following body parameters:

• criteria
• review_date
• is_approved
• completion_status

THEN the app should receive a status 200
AND in the response, the following information should be returned:

• header message indicating update operation success

Sample Request/Sample Response

headers: {
    error: 0,
    message: "The specified item was updated successfully"
}
body: {}

Resources

• Development URL: {Here goes a URL to the feature on development API}
• Production URL: {Here goes a URL to the feature on production API}

Dev Notes

{Some complementary notes if necessary}

Testing Notes

Scenario 1: PATCH request is successful

1. Update a milestone stage with a PATCH request to /milestone-stages/:id endpoint
2. A subsequent GET request to /milestone-stages/:id endpoint should return a status code 200 and the milestone stage's details with the updated information i.e. matching the initially sent body.

Scenario 2: PATCH request is forbidden

1. Send a PATCH request to /milestone-stages/:id endpoint using a home owner account token.
2. Ensure the response returns a 403 forbidden status code.