Cobalt Docs
Api referenceCategories

Delete category

Soft-delete a custom category. Dependent transactions and recurring rows are reassigned to the user's Uncategorized seed category. System categories cannot be deleted — hide them instead.

DELETE
/categories/{categoryId}

Authorization

bearerAuth
AuthorizationBearer <token>

Cobalt API key (prefix ck_live_). Issue from dashboard → Settings → API keys.

In: header

Path Parameters

categoryId*string

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/categories/497f6eca-6276-4993-bfeb-53cbbbba6f08"
Empty
{
  "code": "string",
  "error": "string"
}
{
  "code": "string",
  "error": "string"
}
{
  "code": "string",
  "error": "string"
}
{
  "error": {
    "issues": [
      {
        "code": "string",
        "message": "string",
        "path": [
          "string"
        ]
      }
    ],
    "name": "string"
  },
  "success": true
}