Connector API

Getting started

Import, configure, and run Socialistic skills from your own systems. Base URL: https://connector.socialistic.ai. Requests and responses are JSON unless noted; the run event stream is server-sent events.

Authentication

Every request carries a bearer API key in the Authorization header. Mint a key from Settings → API Keysand copy it (you can re-copy it any time). The key acts as you: imports land in your account, configuration changes apply to your skills, and hosted runs draw your wallet. A skill you don’t own returns 404— existence never leaks.

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Missing key → 401 UNAUTHORIZED. Unknown / deleted key → 401 INVALID_API_KEY.

Quick start

# 1. mint a key in Settings → API Keys, then:
export KEY=sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

# 2. import a skill
curl -X POST https://connector.socialistic.ai/v1/skills/import \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{ "github_url": "https://github.com/<org>/<repo>" }'

# 3. start a session
curl -X POST https://connector.socialistic.ai/v1/sessions \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{ "skill_slug": "my-skill-ab12cd", "consumption_mode": "pay" }'

# 4. send a message → poll until running → stream events (see Streaming tab)