Remove Trigger

Delete an existing trigger.

Endpoint

DELETE https://enterprise.guardis.io/v1/triggers/remove

Authentication

Include your API key in the X-API-Key header.

X-API-Key: your_api_key_here

---

Request Body

{
  "trigger_id": "my-unique-trigger-001"
}

Field	Type	Required	Description
trigger_id	string	Yes	The unique identifier of the trigger to remove

---

Example Request

curl -X DELETE "https://enterprise.guardis.io/v1/triggers/remove" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "trigger_id": "my-unique-trigger-001"
  }'

---

Response

Success (200 OK)

{
  "trigger_id": "my-unique-trigger-001",
  "status": "deleted",
  "deleted_at": "2025-01-15T16:52:18.000Z"
}

---

Example Usage

JavaScript:

const response = await fetch("https://enterprise.guardis.io/v1/triggers/remove", {
  method: "DELETE",
  headers: {
    "X-API-Key": "your_api_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    trigger_id: "my-unique-trigger-001"
  })
});

const result = await response.json();
console.log(`Trigger ${result.trigger_id} deleted at ${result.deleted_at}`);

Python:

import requests

response = requests.delete(
    "https://enterprise.guardis.io/v1/triggers/remove",
    headers={
        "X-API-Key": "your_api_key_here",
        "Content-Type": "application/json"
    },
    json={
        "trigger_id": "my-unique-trigger-001"
    }
)

result = response.json()
print(f"Trigger {result['trigger_id']} deleted at {result['deleted_at']}")

---

Error Responses

Status Code	Description
400	Invalid request body or missing trigger_id
401	Missing or invalid API key
404	Trigger not found
500	Internal server error

{
  "code": 400,
  "message": "Missing required field: trigger_id"
}

{
  "code": 404,
  "message": "Trigger with ID 'my-unique-trigger-001' not found"
}