Webhooks

{
  "event": "session.completed",
  "sessionId": "s1b2c3d4-5678-9abc-def0-1234567890ab",
  "assessmentId": "a1b2c3d4-5678-9abc-def0-1234567890ab",
  "candidateKey": "PST-A3K7-M9X2",
  "completedAt": "2026-04-07T14:30:00.000Z",
  "artifactsReady": true
}

{
  "event": "assessment.key.redeemed",
  "key": "PST-A3K7-M9X2",
  "assessmentId": "a1b2c3d4-5678-9abc-def0-1234567890ab",
  "candidateEmail": "[email protected]",
  "redeemedAt": "2026-04-07T12:00:00.000Z"
}

import requests
import time
import os

API_KEY = os.environ["PROMPTSTER_API_KEY"]
BASE = "https://api.promptster.ai"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}


def poll_completed_sessions(assessment_id, interval_seconds=60):
    """Poll for newly completed sessions."""
    seen = set()

    while True:
        res = requests.get(
            f"{BASE}/v1/sessions",
            headers=HEADERS,
            params={"assessmentId": assessment_id, "limit": 100},
        )
        res.raise_for_status()

        for session in res.json()["sessions"]:
            sid = session["id"]
            if session["endedAt"] and sid not in seen:
                seen.add(sid)
                handle_completed_session(sid)

        time.sleep(interval_seconds)


def handle_completed_session(session_id):
    """Process a completed session."""
    # Wait briefly for artifact generation
    time.sleep(45)

    res = requests.get(
        f"{BASE}/v1/sessions/{session_id}/artifacts",
        headers=HEADERS,
    )
    artifacts = res.json()["artifacts"]
    print(f"Session {session_id}: {len(artifacts)} artifacts ready")

def poll_key_status(assessment_id):
    """Check for newly redeemed keys."""
    res = requests.get(
        f"{BASE}/v1/assessments/{assessment_id}/keys",
        headers=HEADERS,
    )

    for key in res.json()["keys"]:
        if key["status"] == "active" and key["redeemedAt"]:
            print(f"{key['candidateName']} started at {key['redeemedAt']}")
        elif key["status"] == "completed":
            print(f"{key['candidateName']} completed at {key['completedAt']}")