Requests

curl -X POST http://localhost:8776/api/v1/requests \
  -H "Authorization: Bearer $SHOULDERTAP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "glossary.definition",
    "topic": "revenue metrics",
    "question": "What does '\''active customer'\'' mean for Q2 reporting?",
    "consumer": "bi.assistant",
    "context": {
      "asked_because": "BI agent hit low confidence answering a user query",
      "entity": "dim_customers.active_flag"
    },
    "dedup_key": "glossary:dim_customers.active_flag"
  }'

{ "id": "req_01J...", "status": "queued" }

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

{
  "id": "req_01J...",
  "kind": "glossary.definition",
  "topic": "revenue metrics",
  "question": "What does 'active customer' mean for Q2 reporting?",
  "consumer": "bi.assistant",
  "status": "accepted",
  "subscribers": ["bi.assistant"],
  "routing_policy": { "priority": 50 },
  "proposal": { "id": "prop_01J...", "answer": "paying accounts active in 90 days" }
}