Skip to main content

​
Growth surface

Growth helps users discover opportunities and turn them into executable projects.

​
Primary capabilities

  • List opportunity cards with impact metadata
  • Load opportunity detail by insightId
  • List active projects and progress
  • Create projects from opportunities
  • Activate or deactivate project execution status

​
Key endpoints

  • GET /api/growth/opps
  • GET /api/growth/opp/detail
  • GET /api/growth/projects
  • POST /api/projects/from_opp
  • POST /api/projects/active/set

​
Request and response examples

GET /api/growth/opps?asOfDate=2026-03-03
Authorization: Bearer <accessToken>

POST /api/projects/from_opp
Content-Type: application/json
Authorization: Bearer <accessToken>

{
  "insightId": "12001"
}

​
Response model notes

  • Opportunity list returns both id (row id) and insightId (stable entity id).
  • Project list includes execution fields: stepsCompleted, stepsTotal, isActive.

​
Common error patterns

  • 401 Unauthorized: missing or expired access token
  • 400 Bad Request: invalid opportunity/project payload
  • 404 Not Found: opportunity or project unavailable in current user scope