Skip to main content
PUT
/
grievances
/
{grievance_id}
cURL
curl --request PUT \
  --url https://grm-api.vercel.app/grievances/{grievance_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "Active",
  "resolution_notes": "<string>",
  "officer_closed_by": "<string>",
  "final_status": "<string>",
  "grievance_closing_date": "2023-11-07T05:31:56Z"
}
'
{
  "id": "<string>",
  "status": "<string>",
  "updated_fields": {}
}
Updates the status of an existing grievance. This endpoint requires authentication via a bearer token. The required field is status, which must be one of the valid status options (pending, in_progress, resolved, rejected). Optional fields include resolution_notes which can provide additional information about the status change. If the grievance is not found, a 404 error is returned. If an invalid status is provided, a 400 error is returned with details about the valid status options. The response includes the ID of the updated grievance, a status message indicating successful update, and the fields that were updated.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
grievance_id
string
required

ID of grievance to update

Body

application/json

Status update for the grievance

​
status
enum<string>

New status for the grievance

Available options:
Active,
Pending,
Closed with resolution,
Closed without resolution,
Tender Issued
​
resolution_notes
string

Notes explaining the resolution or status change

​
officer_closed_by
string

Officer who closed the grievance

​
final_status
string

Final status of the grievance

​
grievance_closing_date
string<date-time>

Date when the grievance was closed

Response

Updated grievance

​
id
string

ID of the updated grievance

​
status
string

Status message

​
updated_fields
object

Fields that were updated