Authentication

Create an API key in Settings -> Connections. Send it as a Bearer token in the Authorization header.

curl https://api.netcoach.ai/v1/me \
  -H "Authorization: Bearer nc_live_sk_abc123..."

Endpoints

Example: coaching session

curl https://api.netcoach.ai/v1/chat/sessions \
  -X POST \
  -H "Authorization: Bearer $NC_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Wie baue ich Resilienz auf?", "framework": "trinity" }'

Webhooks

We sign every payload with X-NetCoach-Signature (HMAC-SHA256 over the raw body, prefixed with v1=). Retries: 5x with exponential backoff (1s, 4s, 16s, 64s, 256s).

Payload example: tier.upgraded

{
  "id": "evt_01HXYZ...",
  "type": "tier.upgraded",
  "created": "2026-05-26T10:14:33Z",
  "data": {
    "user_id": "usr_abc123",
    "from_tier": "gold",
    "to_tier": "platinum",
    "xp_total": 15042,
    "verified_mentees": 25
  },
  "signature_version": "v1"
}

Rate-Limits

More examples

Full example repos on GitLab: gitlab.com/2026-netcoach/sdk-examples.