Python SDK

pip install nixflex

from nixflex import Nixflex

client = Nixflex(api_key="nxf_xxx:nxfs_xxx")   # both halves, joined by a colon

from nixflex import AsyncNixflex

async with AsyncNixflex(api_key="nxf_xxx:nxfs_xxx") as client:
    agents = await client.agents.list()

agent = client.agents.create(name="Reception", system_prompt=open("prompt.txt").read(), voice_id="Ashley")
client.agents.list(limit=20)
client.agents.get(agent["agent_id"])
client.agents.update(agent["agent_id"], incall_sms_enabled=True, silence_hangup_seconds=12)
client.agents.delete(agent["agent_id"])

call = client.calls.create(
    agent_id=agent["agent_id"],
    to_number="+447453573770",
    prompt="Call Sam to confirm his appointment on Tuesday at 11.",
    variables={"name": "Sam"},
)
client.calls.list(limit=20)
client.calls.get(call["call_id"])          # transcript, analysis, bookings, recording_url
client.calls.delete(call["call_id"])       # record + recording (GDPR)

client.phone_numbers.import_(phone_number="+447446466847", agent_id=agent["agent_id"], twilio_account_sid="AC...", twilio_auth_token="...")
client.phone_numbers.list()
client.phone_numbers.update("+447446466847", sms_reply_enabled=True, sms_prompt="You are the text assistant for Smile Dental...")
client.phone_numbers.set_monitor("+447446466847", True)
client.phone_numbers.set_web_calls("+447446466847", True)
client.phone_numbers.delete("+447446466847")

client.callers.set("+447446466847", "+447700900123", name="Sam Carter", email="sam.carter@example.com", reference_id="4827")
record = client.callers.get("+447446466847", "+447700900123")
record["caller"]["context"]        # {"name": ..., "email": ..., "last_call": ..., "open_item": ...}

client.callers.import_("+447446466847", [
    {"caller_number": "+447700900123", "name": "Sam Carter", "email": "sam.carter@example.com"},
    {"caller_number": "+447700900124", "name": "Priya Shah", "preference": "prefers afternoon appointments"},
])                                  # up to 1,000 rows, validated before any write
client.callers.delete("+447446466847", "+447700900123")

client.sms.send(agent_id=agent["agent_id"], from_number="+447446466847", to="+447700900123", message="Reminder: your appointment is tomorrow at 2pm.")

campaign = client.sms.campaigns.create(agent_id=..., from_number="+447446466847", message="Hi {{name}}, ...", recipients=[{"phone": "+447700900123", "variables": {"name": "Sam"}}])
client.sms.campaigns.launch(campaign["campaign_id"])
client.sms.campaigns.list(status="completed")
client.sms.campaigns.get(campaign["campaign_id"])
client.sms.campaigns.delete(campaign["campaign_id"])

client.webhooks.set("+447446466847", "https://api.yourapp.com/nixflex", slot=1)
client.webhooks.get("+447446466847")
client.webhooks.delete("+447446466847", slot=2)

from nixflex import verify_webhook_signature

@app.post("/nixflex")
async def hook(request):
    raw = await request.body()
    if not verify_webhook_signature(raw, request.headers.get("X-Nixflex-Signature"), KEY_SECRET):
        return Response(status_code=401)
    ...

client.usage.get()
client.keys.rotate()                       # the old secret stops working immediately

client.storage.set(**config); client.storage.get(); client.storage.delete()
client.llm.set(**config);     client.llm.get();     client.llm.delete()
client.tts.set(**config);     client.tts.get();     client.tts.delete()

from nixflex import NixflexRateLimitError, NixflexNotFoundError, NixflexError

try:
    client.agents.get("agent_missing")
except NixflexNotFoundError as e:
    print(e.code, e.status, e.request_id)   # not_found 404 <id to quote to support>
except NixflexRateLimitError as e:
    time.sleep(e.retry_after_seconds)
except NixflexError as e:
    print(e.code, e.doc_url)