Skip to content
Gospl Wiki

Overview

Gospl — MVP Nominations API 0.1.0-draft

Section titled “Gospl — MVP Nominations API 0.1.0-draft”

Contract for the MVP (Individual & Team Nominations) module. Authored by Claude as the handoff artifact to the external API team. Drives: their implementation target, Gospl’s client types, the Prism mock, and the wiki API page. Traceability: x-gospl-frs lists the spec US/section IDs each operation satisfies. Contract tests tag to these. OPEN CLARIFICATIONS baked in as TODOs (see specs/people/mvp-nominations.md §C): Q1 Team deadline date · G1 working-day calendar · G2 winner-setting (no endpoint yet) · G3 nomination cardinality · Q4 People-Team access role · Q5 employee directory source · Q6 anonymity/visibility of nominators. AI insights (§3.5 / US-12) are Phase 2 — intentionally absent here.

Information

  • OpenAPI version: 3.1.0

Operations

Section titled “ Operations ”
GET
/mvp/page
GET
/mvp/current-holders
GET
/mvp/deadlines
POST
/mvp/nominations/individual
POST
/mvp/nominations/team
GET
/mvp/nominations/me
GET
/mvp/reports/outstanding-nominators
GET
/mvp/reports/export
GET
/mvp/reports/export/by-individual

Authentication

Section titled “ Authentication ”

bearerAuth

Section titled “bearerAuth ”

Token carries tenant + viewer identity + roles. All endpoints tenant-scoped; reporting endpoints require the People-Team role (Q4).

Security scheme type: http

Bearer format: JWT