API docs / API reference

Delete a contribution

DELETE/v1/contributions/{id}

Remove a contribution by its Equity Matrix ID or by its external ID.

Request

By Equity Matrix ID:

curl -X DELETE https://api.equitymatrix.io/v1/contributions/1842 \
  -H "Authorization: Bearer $EQUITY_MATRIX_API_KEY"

By external ID, which is what a sync usually has. Colons and dots can go in the URL as they are:

curl -X DELETE https://api.equitymatrix.io/v1/contributions/external/harvest:time_entry:2291837 \
  -H "Authorization: Bearer $EQUITY_MATRIX_API_KEY"

Response

204 with no body. The contribution stops counting toward equity right away, the same as deleting it in the app. Nobody is notified.

  • A contribution that doesn’t exist, was already deleted, or belongs to another organization returns a 404. From a sync, treat that as done.
  • A key can delete any contribution in its organization, including ones logged in the app.
  • Sending the same externalId again after a delete creates a new contribution.