Skip to content

by Startups.Studio

Idea.pursue

POST /{namespace}/ideas/{idea}/pursue

Pursue starts a Startup on an Idea as one variant of the Experiment that tests the Idea.

Noun: Idea
Mode: do
Event: Idea.pursued

You, to your agent

Pursue the latest idea.

curl -X POST https://api.sb/shiftnote.app/ideas/idea_1/pursue \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"

import { $ } from 'startup-builder'

const { startup, idea } = await $.Idea.pursue({ idea: 'idea_1' })

npx startup-builder do Idea.pursue --json '{"idea":"idea_1"}'

{
  "name": "do",
  "arguments": {
    "code": "return await $.Idea.pursue({ idea: 'idea_1' })"
  }
}

Inputs

Input	Type	Required	Description
`idea`	Idea	required	The Idea to pursue.
`template`	Template		The Template the variant extends.

Outputs

Output	Type	Required	Description
`startup`	Startup	required	The new variant Startup.
`idea`	Idea	required	The Idea now pursued.

Effects

Emits Idea.pursued.
Performed by the Founder.
Adds the Startup as a variant of the Idea’s Experiment.

Refuses when

Check	Error	Fix	Then call
The input does not match the schema of the operation.	`invalid-input`	Read the schema of the operation, then send every required field with the right type.	Idea.pursue
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.	Idea.pursue

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`.