darkhunt-api

Python client for the Darkhunt public API.

Generated from the public OpenAPI contracts. The full API reference, including request and response schemas, is at docs.darkhunt.ai.

Install

pip install darkhunt-api

Usage

Each service is a submodule with its own client, configuration and models.

from darkhunt_api.workflow_manager import ApiClient, Configuration, WorkspacesApi

config = Configuration(
    host="https://api.darkhunt.ai/workflow-manager",
    access_token="dh-...",           # API key, or an OAuth access token
)

with ApiClient(config) as client:
    workspaces = WorkspacesApi(client).list_workspaces(tenant_id="...")

from darkhunt_api.guardrail_manager import ApiClient, Configuration, GuardrailRulesApi

config = Configuration(
    host="https://api.darkhunt.ai/guardrail-manager",
    access_token="dh-...",
)

with ApiClient(config) as client:
    rules = GuardrailRulesApi(client).list_guardrail_rules(tenant_id="...")

Create and revoke API keys under Settings → Security → API Keys. A key carries the same privileges as the account that created it — treat it like a password.

Versioning

This package has its own version, independent of the API contracts it wraps — it ships several services, and they version separately. The contract revision each module was generated from is recorded in the package:

import darkhunt_api
darkhunt_api.CONTRACT_VERSIONS
# {'guardrail_manager': '0.5.0', 'workflow_manager': '0.29.0'}

from darkhunt_api import workflow_manager
workflow_manager.__version__      # the workflow-manager contract version

License

Apache-2.0