Python

pip install praxicraft

export PRAXICRAFT_API_KEY="ct_live_xxxxxxxxxxxxxxxx"

from praxicraft import Client

client = Client()  # reads PRAXICRAFT_API_KEY
# or Client(api_key="ct_live_…", base_url="https://assess.praxicraft.com")

from praxicraft import Client

client = Client()

page = client.assessments.list()
for assessment in page["results"]:
    print(assessment["slug"], assessment["status"])

invite = client.invites.create(
    "senior-backend-screen",
    email="[email protected]",
    name="Jane Doe",
    send_email=True,
)
print(invite["invite_token"], invite.get("invite_url"))

result = client.results.retrieve(invite_token=invite["invite_token"])
print(result)

org = client.org.retrieve()
if (org.get("invites_remaining") or 0) < len(candidates):
    raise SystemExit("Not enough invites remaining this month")

assessment = client.assessments.create(title="Backend screen")
client.assessments.attach_cases(
    assessment["slug"],
    cases=[{"case_id": "<uuid>", "source": "platform"}],
)
client.assessments.activate(assessment["slug"])

hook = client.webhooks.create(
    url="https://example.com/hooks/praxicraft",
    events=["assessment.completed", "candidate.passed"],
)
# Store hook["secret_key"] (whsec_…) — shown once
client.webhooks.test(hook["id"])
client.webhooks.update(hook["id"], is_active=True)

for row in client.results.iter_all("senior-backend-screen", page_size=50):
    print(row.get("email"), row.get("score_percentage"), row.get("passed"))

from praxicraft import (
    AuthenticationError,
    InsufficientScopeError,
    RateLimitError,
    ValidationError,
)

try:
    client.invites.create("demo", email="[email protected]")
except ValidationError as exc:
    print(exc.code, exc.details)
except InsufficientScopeError as exc:
    print(exc.code)
except AuthenticationError as exc:
    print(exc.code)
except RateLimitError as exc:
    print(exc.retry_after)