Skip to content

by Startups.Studio

Problem.rank

POST /{namespace}/problems/rank

Rank orders Problems by revenue at stake, Evidence grade and effort, so the next Project addresses the top one.

Noun: Problem
Mode: do
Event: Problem.ranked

You, to your agent

Rank the latest problem.

curl -X POST https://api.sb/patentpad.com/problems/rank \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"icp":"icp_1"}'

import { $ } from 'startup-builder'

const problems = await $.Problem.rank({ icp: 'icp_1' })

npx startup-builder do Problem.rank --json '{"icp":"icp_1"}'

{
  "name": "do",
  "arguments": {
    "code": "return await $.Problem.rank({ icp: 'icp_1' })"
  }
}

Inputs

Input	Type	Required	Description
`icp`	ICP		The ICP whose Problems to rank; omitted, every ICP.

Outputs

Output	Type	Required	Description
`problems`	list of Problem	required	Problems, highest first, each with its score.

Effects

Emits Problem.ranked.
Performed by the Product Lead.
Two-way: it runs at once, in the try, send and do modes.
Reads the Founding Hypothesis slot each Problem binds to and its weakest Evidence grade.

Refuses when

Check	Error	Fix	Then call
The key is valid, but its scopes do not allow this operation.	`forbidden`	Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them.	Problem.rank

When it waits

Gate	Default
Decision class	Low: two-way, nothing at stake
Delay window	None: it runs once review passes.
Limit	The call Limit of the Permission it runs under.
Over the Limit	It waits `pending` for an Approval from the Founder. Approved, it runs; refused, it ends `refused` with `limit-exceeded`; unanswered by its deadline, it ends `canceled`.

Problem.list

Previous Page

Problem.suggest

Next Page