Proposals

Proposals are expert answers awaiting human review. These endpoints back the approval queue.

List pending proposals

GET /api/v1/proposals?status=pending

curl "http://localhost:8776/api/v1/proposals?status=pending" \
  -H "Authorization: Bearer $SHOULDERTAP_API_TOKEN"

Returns the pending ContextProposals. Each carries its id, its request_id, the expert’s answer, the structured form, confidence, and provenance.

status

pending

Currently only pending is supported — the queue of proposals awaiting a decision.

Accept a proposal

POST /api/v1/proposals/{id}/accept Approves the answer and delivers it to every subscribed consumer via on_proposal_accepted.

curl -X POST http://localhost:8776/api/v1/proposals/prop_01J.../accept \
  -H "Authorization: Bearer $SHOULDERTAP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"decided_by": "alice"}'

decided_by

string

required

Who approved the proposal.

note

string

An optional note recorded with the decision.

Returns the updated proposal. Accepting also sets the request’s status to accepted and notifies the expert that their answer was accepted. An unknown id returns 404; deciding an already-decided proposal is a no-op.

Reject a proposal

POST /api/v1/proposals/{id}/reject

curl -X POST http://localhost:8776/api/v1/proposals/prop_01J.../reject \
  -H "Authorization: Bearer $SHOULDERTAP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"decided_by": "alice", "reason": "not accurate"}'

decided_by

string

required

Who rejected the proposal.

reason

string

required

Why it was rejected. Delivered to the consumer with on_proposal_rejected.

Returns the updated proposal and sets the request’s status to rejected.

Overview

Contracts

Endpoints

List pending proposals

Accept a proposal

Reject a proposal

​List pending proposals

​Accept a proposal

​Reject a proposal

List pending proposals

Accept a proposal

Reject a proposal