REST API

import time
import requests

API_KEY = "ch_YOUR_KEY"  # Create one on your team page; use an env var in real code

# 1. Upload a drawing and start an AI review in one call
response = requests.post(
    "https://www.clearhandoff.com/api/v1/drawings/",
    headers={"Authorization": f"Bearer {API_KEY}"},
    files={"file": open("drawing.pdf", "rb")},
    data={"name": "My Drawing", "trigger_ai_review": "true"},
)
drawing = response.json()
drawing_id = drawing["id"]
review_id = drawing["review_id"]

# 2. Poll for results (reviews typically complete in 1-3 minutes)
while True:
    response = requests.get(
        f"https://www.clearhandoff.com/api/v1/drawings/{drawing_id}/ai-review/{review_id}/",
        headers={"Authorization": f"Bearer {API_KEY}"},
    )
    result = response.json()
    if result["status"] in ("completed", "failed"):
        print(result)
        break
    time.sleep(5)