Experts

These endpoints expose the expert registry. See Experts and routing for how experts are matched.

List experts

GET /api/v1/experts Returns each expert’s configuration plus the live state the engine tracks.

curl http://localhost:8776/api/v1/experts \
  -H "Authorization: Bearer $SHOULDERTAP_API_TOKEN"

[
  {
    "id": "U0123ABC",
    "name": "Dana Kim",
    "topics": ["revenue metrics", "customer definitions"],
    "escalation_to": "U0456DEF",
    "muted": false,
    "open_asks": 1,
    "asks_today": 2
  }
]

string

The expert’s Slack user ID.

string

array

string | null

boolean

Whether the expert has opted out with mute.

integer

Unanswered asks currently outstanding.

integer

Asks sent to this expert today.

Replace the registry

PUT /api/v1/experts Replaces the entire registry with the array you send — this is a full replace, not a merge.

curl -X PUT http://localhost:8776/api/v1/experts \
  -H "Authorization: Bearer $SHOULDERTAP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[{"id": "U0123ABC", "name": "Dana Kim", "topics": ["revenue metrics"], "escalation_to": "U0456DEF"}]'

Each entry takes id, name, topics, and optional escalation_to. Returns the updated registry with live state.

PUT /experts rewrites the experts: section of shouldertap.yaml on disk — the config file remains the source of truth. Anything you omit from the array is removed.

Overview

Contracts

Endpoints

List experts

Replace the registry

​List experts

​Replace the registry

List experts

Replace the registry