domani

Official Python SDK for the domani API - domains, email, and identity for AI agents. Typed, generated from the OpenAPI spec, standard-library only (no dependencies).

Install

pip install domani

Requires Python 3.8+.

Quickstart

from domani import Domani, DomaniError

domani = Domani(api_key="domani_sk_...")

# Search availability + pricing
results = domani.search(query={"q": "myagent.com"})

# Give an agent an inbox
domani.create_mailbox_by_address(body={"address": "hi@myagent.com"})

# Send mail
domani.send_email_by_address(
    "hi@myagent.com",
    body={"to": "user@example.com", "subject": "Hello", "text": "Sent from my domani mailbox."},
)

# Errors carry the API's structured code + hint
try:
    domani.send_email_by_address("hi@myagent.com", body={"to": "bounced@example.com", "text": "..."})
except DomaniError as e:
    print(e.status, e.code, e.hint)  # e.g. 400 RECIPIENTS_SUPPRESSED

API

Domani(api_key, base_url=..., timeout=...) exposes one method per API operation (named after its operationId in snake_case). Path parameters are positional; request bodies (body=) and query objects (query=) are keyword arguments. Every method returns the parsed JSON response and raises DomaniError (status, code, hint, documentation_url) on non-2xx.

Full endpoint reference: https://domani.run/docs · OpenAPI spec: https://domani.run/.well-known/openapi.json

Generated

domani/__init__.py is generated from the domani OpenAPI spec - do not edit it by hand. It is regenerated whenever the API surface changes.

License

MIT