Docs API Reference Complaint/bff/complaint/set-status

/bff/complaint/set-status

Changes complaint status and records the transition in the event timeline. Statuses "resolve" and "closed" automatically set is_resolved flag and resolved_date.

ComplaintpostBffComplaintSet-status

Parameters

JSON body

Request body

application/json

complaintIdstringRequired

Complaint external ID.

Examplea1b2c3d4

statusstringRequired

New status code. Setting "resolve" or "closed" automatically marks the complaint as resolved.

Examplesnewopenwaitresolverejectclosed

messagestringOptional

Optional note explaining the status change. Visible in the complaint timeline.

ExampleAwaiting customer response.

Response schema

1 status code documented

200Success

successbooleanRequired

Indicates whether the operation completed successfully.

Default: true

Response example

application/json

{
  "success": true
}

Request example

POST /bff/complaint/set-status

post

curl -X POST "https://api.bizkithub.com/bff/complaint/set-status" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "complaintId": "a1b2c3d4",
  "status": "new",
  "message": "Awaiting customer response."
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key