Delete draft journal entry

DEL

/v1/journal-entries/{id}

Deletes a draft. Its bank links and suggestions go with it; its document stays and becomes unlinked. Booked entries cannot be deleted.

Requires one ofjournal:write write:draft write:ledger

Path parameters

idstring (uuid)Required
Journal entry ID, as returned when it was created

Errors

401Invalid or missing authentication
403Missing scope, or the company is archived
404The resource does not exist in this company
409The entry is booked, or Numina's bookkeeping agent is working on it. Retry in a few minutes if the agent is the cause.
429Rate limit exceeded
500Internal Server Error

Every error has the same shape. See Errors.

cURL

curl -X DELETE https://api.numina.app/v1/journal-entries/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer numi_YOUR_API_KEY"

JavaScript

const response = await fetch("https://api.numina.app/v1/journal-entries/550e8400-e29b-41d4-a716-446655440000", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.NUMINA_API_KEY}`,
  },
});

const data = await response.json();

Python

import os

import requests

response = requests.delete(
    "https://api.numina.app/v1/journal-entries/550e8400-e29b-41d4-a716-446655440000",
    headers={
        "Authorization": f"Bearer {os.environ['NUMINA_API_KEY']}",
    },
)
data = response.json()