Partython
HTTP Gateway · v1

The Partython AI gateway.

You've reached the public API host. The full reference, SDKs, and webhook setup all live in the docs — keys are issued from the dashboard.

Base URL https://api.partython.com All systems operational v1 · stable
Documentation

API reference

Quickstart, auth, /v1/respond schema, errors, rate limits, webhooks.

Open docs →
Dashboard

Issue an API key

Sign in, open Settings → API Keys, click Generate. Plaintext is shown once.

Open dashboard →
SDKs

JS · Python · React

Drop-in libraries with shared error hierarchy and request_id surfacing.

Install →
01

Quickstart

curl
curl https://api.partython.com/api/v1/respond \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "web",
    "channel_user_id": "user-abc",
    "message_text": "I need party supplies for 12 kids"
  }'
02

Key endpoints

POST /api/v1/respond Conversational turn (public, pk_live_…)
POST /api/v1/auth/login Dashboard session login
GET /api/v1/conversations/ List a tenant's conversations
POST /api/v1/knowledge/search Semantic search over uploaded docs
WS /ws/conversations/:id Real-time inbox stream
POST /api/meta/webhook WhatsApp / Instagram / Messenger ingress

Full catalogue with request bodies, response schemas, and error codes lives in the API reference.