Delete intent-rule draft version

curl --request DELETE \
  --url 'https://api-prod.usefini.com/v2/hc-rules/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/versions/v3/public' \
  --header 'Authorization: Bearer fini_your_api_key'

const ruleId = "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3";
const versionId = "v3";

const response = await fetch(
  `https://api-prod.usefini.com/v2/hc-rules/${ruleId}/versions/${versionId}/public`,
  {
    method: "DELETE",
    headers: {
      Authorization: "Bearer fini_your_api_key",
    },
  }
);

if (!response.ok) {
  throw new Error(`Delete failed: ${response.status}`);
}

import requests

rule_id = "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3"
version_id = "v3"
response = requests.delete(
    f"https://api-prod.usefini.com/v2/hc-rules/{rule_id}/versions/{version_id}/public",
    headers={"Authorization": "Bearer fini_your_api_key"},
)
response.raise_for_status()

DELETE

hc-rules

{id}

versions

{versionId}

public

curl --request DELETE \
  --url 'https://api-prod.usefini.com/v2/hc-rules/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/versions/v3/public' \
  --header 'Authorization: Bearer fini_your_api_key'

const ruleId = "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3";
const versionId = "v3";

const response = await fetch(
  `https://api-prod.usefini.com/v2/hc-rules/${ruleId}/versions/${versionId}/public`,
  {
    method: "DELETE",
    headers: {
      Authorization: "Bearer fini_your_api_key",
    },
  }
);

if (!response.ok) {
  throw new Error(`Delete failed: ${response.status}`);
}

import requests

rule_id = "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3"
version_id = "v3"
response = requests.delete(
    f"https://api-prod.usefini.com/v2/hc-rules/{rule_id}/versions/{version_id}/public",
    headers={"Authorization": "Bearer fini_your_api_key"},
)
response.raise_for_status()

Deletes one draft version of an intent rule. The route only deletes versions with status: "DRAFT"; published and archived versions stay in the rule’s version history.

This endpoint supports intent rules only. Business Rules are published immediately and do not have draft versions.

Deleting a draft removes it from normal version-history reads. It does not change the rule’s current published version or its agent assignments.

Headers

string

required

Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs write scope.

Path parameters

string

required

Intent-rule ID.

string

required

Exact draft version ID to delete.

Response

Returns 204 No Content when the delete succeeds. The response body is empty.

curl --request DELETE \
  --url 'https://api-prod.usefini.com/v2/hc-rules/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/versions/v3/public' \
  --header 'Authorization: Bearer fini_your_api_key'

const ruleId = "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3";
const versionId = "v3";

const response = await fetch(
  `https://api-prod.usefini.com/v2/hc-rules/${ruleId}/versions/${versionId}/public`,
  {
    method: "DELETE",
    headers: {
      Authorization: "Bearer fini_your_api_key",
    },
  }
);

if (!response.ok) {
  throw new Error(`Delete failed: ${response.status}`);
}

import requests

rule_id = "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3"
version_id = "v3"
response = requests.delete(
    f"https://api-prod.usefini.com/v2/hc-rules/{rule_id}/versions/{version_id}/public",
    headers={"Authorization": "Bearer fini_your_api_key"},
)
response.raise_for_status()

Errors

401 Unauthorized

The API key is missing, malformed, revoked, or invalid.

403 Forbidden

The API key does not include write scope.

404 Not Found

The rule, version, or draft does not exist in your workspace, or the version is not a draft.

​Headers

​Path parameters

​Response

​Errors

Headers

Path parameters

Response

Errors