refactual-sdk 0.1.1

Official Refactual REST API client for Python.

refactual-sdk

Official Refactual REST API client for Python.

Preview release (0.x) — APIs may shift before 1.0.0. Pin exact versions in production and follow the changelog for breaking notes.

pip install refactual-sdk

Quickstart

from refactual import Refactual

client = Refactual(api_key="rk_live_...")
reply  = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Explain async/await"}],
)
print(reply["content"])

OAuth 2.0 (client_credentials)

token = Refactual(api_key="rk_placeholder").oauth.token(
    client_id="rc_live_xxx",
    client_secret="rcs_live_xxx",
    scope=["chat:write", "chat:read"],
)
client = Refactual(access_token=token["access_token"])

Webhook verification

from refactual import verify_webhook
verify_webhook(raw_body, request.headers.get("Refactual-Signature"), secret)

See API.md for the full reference.