Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Read the expert registry with live state, or replace it wholesale, over the ShoulderTap HTTP API.
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
}
]
mute.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"}]'
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.