Rules

Delete rule

Deletes a company automation rule. Accepts no request body, including an empty JSON object. Requires Accounting setup: Manage, Transactions: Manage and API access: Manage on every request, including retries for absent IDs. Permission checks precede body and ID validation, so callers missing Transactions: Manage receive 403 even for malformed IDs or requests with a body. Successful deletion and already-absent rules return 204 with no body. Foreign-company, global, internal/system, owner-specific and mixed-owner records are indistinguishable from absence and are not changed. Malformed rule_ IDs return 400 invalid_request. Transactions directly linked through rule_id can have their categories reset to defaults; matched transfer legs keep their categories and are detached from the rule. This is not a general undo of every rule action and does not promise that historical transactions remain unchanged. Retries after success do not repeat these effects. No Idempotency-Key is required. Queued API historical application is cancelled atomically with deletion. Already-running work returns retryable 503 rule_busy without changes; retry with exponential backoff. Legacy unassociated UI jobs do not gain these cancellation guarantees. Missing-resource associated jobs safely cancel without recreating the rule. Deletion does not validate or serialize the stored definition, so stale references or definitions not representable by the API do not prevent deletion. A failed deletion rolls back category changes, rule deletion and history cancellation and returns 500 api_error with code rule_deletion_failed, never 204. Unexpected server errors use existing server handling. Retry failed or interrupted requests with exponential backoff; seek operator help for persistent failures. No new history, migration, backfill, feature flag or public job API is added.

DELETE

rules

{id}

Delete rule

curl --request DELETE \
  --url https://app.finta.com/api/v1/rules/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.finta.com/api/v1/rules/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.finta.com/api/v1/rules/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.finta.com/api/v1/rules/{id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.finta.com/api/v1/rules/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

Authorizations

Authorization

string

header

required

API key prefixed with finta_

Path Parameters

string

required

Public rule_ ID with a nonempty alphanumeric suffix of any length.

Pattern: ^rule_[A-Za-z0-9]+$

Response

Rule deleted or absent in the authenticated scope. No response body.

Delete rule

curl --request DELETE \
  --url https://app.finta.com/api/v1/rules/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.finta.com/api/v1/rules/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.finta.com/api/v1/rules/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.finta.com/api/v1/rules/{id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.finta.com/api/v1/rules/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

API Reference

Company

Team

Categories

Rules

Departments

Integrations

Aggregations

Transactions

Journal Entries

Parties

Reports

Delete rule

Authorizations

Path Parameters

Response