Skip to content

by startups.studio

by Startups.Studio

Problem.notify

POST /{namespace}/problems/{problem}/notify

Notify tells every Contact who voted on a Problem that a Version addressing it shipped, with a link to the change.

Noun: Problem
Mode: do
Event: Problem.notified

You, to your agent

Notify the latest problem.

curl -X POST https://api.sb/leaseline.app/problems/problem_UzvXXfKsJB/notify \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"

import { $ } from 'startup-builder'

const problem = await $.Problem.notify({ problem: 'problem_UzvXXfKsJB' })

npx startup-builder do Problem.notify --json '{"problem":"problem_UzvXXfKsJB"}'

{
  "name": "do",
  "arguments": {
    "code": "return await $.Problem.notify({ problem: 'problem_UzvXXfKsJB' })"
  }
}

Inputs

Input	Type	Required	Description
`problem`	Problem	required	The Problem the Version addresses.
`version`	Version		The Version that shipped.

Outputs

Output	Type	Required	Description
`problem`	Problem	required	The Problem, marked addressed.

Effects

Fact	Value
Action class	None: it runs within its seat's Limits
Door	One-way: it waits out its delay window, then runs
Modes	`try` previews it and stores nothing; `send` returns a pending Action; `do` (default) waits for the result
Idempotent	With a key: a repeat with the same `Idempotency-Key` returns the first Action, and a repeat without one runs again
Undo	Action.undo reverses its records
Emits	`Problem.notified`
Performed by	The Product Lead

Skips voters who unsubscribed or withdrew Consent.

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

When it waits

Gate	Default
Decision class	Medium: one-way, bounded
Delay window	1 business hour, in which a watcher can pause, redirect or cancel it; then it runs.
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

Problem.rank

Next