# PUT /v2/credit_notes/{}/transitions/mark_as_cancelled stops working

Calls to PUT /v2/credit_notes/{}/transitions/mark_as_cancelled on FreeAgent API stopped working on October 2, 2024.

On October 2, 2024, the FreeAgent API removed the PUT /v2/credit_notes/{}/transitions/mark_as_cancelled endpoint. Requests sent to this endpoint fail. The change directly affects any integration attempting to transition credit notes using this cancelled status.

## What to use instead

Use the remaining transitions, mark_as_draft and mark_as_sent, or call DELETE /v2/credit_notes/{id}. Because no direct cancel transition replaces it, moving away from this endpoint requires a decision on whether to delete the credit note or keep it as a draft.

No cancel transition replaces it: whether to delete the credit note or keep it as a draft is the team's call.

- API: FreeAgent API (api.freeagent.com)
- Kind: Endpoint removal
- Announced: October 2, 2024
- Takes effect: October 2, 2024
- Calls after that day: fail
- Calls it hits: `PUT /v2/credit_notes/{}/transitions/mark_as_cancelled`
- Source: [Announcement](https://dev.freeagent.com/docs/changes)
- Verified: October 26, 2026, against FreeAgent API's own pages
- Page: https://www.okapi.bot/providers/freeagent-api/breaking-changes/put-v2-credit-notes-transitions-mark-as-cancelled-stops-working/

## FreeAgent API's words

> Remove deprecated mark_as_cancelled endpoint for Credit Notes

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent