Skip to content

Cancel Testimony ​

Clients can cancel their own testimony while it is in the pending or offered state. Once an offer has been accepted (paid), the testimony can no longer be cancelled.

HTTP Request ​

POST /api/v1/testimonies/{testimony}/cancel

ParameterDescription
cancellationReason string, optionalReason for cancellation (optional).

Response ​

204 No Content

The testimony is successfully transitioned to cancelled state. To verify:

Authentication ​

Requires authentication via Bearer token, a verified email and the client role. Only the testimony's client may cancel it (403 Forbidden otherwise).

401 Unauthorized

json
{
  "message": "Unauthenticated."
}

Error Handling ​

409 Conflict — the testimony is not in a cancellable state (already accepted, completed or cancelled):

json
{
  "message": "Prechod zo stavu [accepted] do stavu [cancelled] nie je možný."
}

409 Conflict — another request changed the testimony at the same moment. Re-fetch it and retry if cancelling still makes sense:

json
{
  "message": "Záznam bol medzitým zmenený. Skúste to znova."
}