Authentication

The Kitsune API uses API keys to authenticate requests. You can view and manage your API keys in the Workspace Dashboard.

Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, etc.

Note: All API requests must be made over HTTPS. Calls made over plain HTTP will fail.

BASH Authentication Header


                            curl https://api.kitsunesustainable.com/v1/ping \

                              -H "Authorization: Bearer ksi_live_sk_..." \

                              -H "Content-Type: application/json"

POST

/v1/alerts/send

Triggers a critical transactional alert to a supply chain node. This endpoint is optimized for high-throughput and guarantees < 200ms processing time.

Body Parameters

recipient_email *

string

The destination email address. Must belong to a verified corporate domain.

alert_type *

enum

Type of infrastructure event.
Values: temp_violation, audit_log, security_breach.

metadata

object

Key-value pairs for audit trails (e.g., Sensor ID, Location Coordinates).

Python (SDK)

import kitsune

kitsune.api_key = "ksi_live_sk_..."

# Send a critical temperature alert
response = kitsune.Alert.create(
  to="ops@logistics-partner.com",
  alert_type="temp_violation",
  priority="high",
  metadata={
    "sensor_id": "IoT-X99",
    "temp_celsius": 8.4
  }
)

print(response.id)

Response (200 OK)

{
  "id": "alt_109238401923",
  "status": "queued",
  "delivery_estimation": "120ms",
  "compliance_check": "passed"
}

Errors

Standard HTTP response codes used by the API.

Code	Description
200 OK	Everything worked as expected.
402 Payment Required	You have hit your plan limits or billing failed.
403 Forbidden	The API key does not have permissions (e.g. sending marketing content is blocked).
429 Too Many Requests	You hit the rate limit. Default: 500 req/sec for Enterprise.