Skip to content
StartupBuilderby Startups.Studio
Business
Changelog
Core grammar

Question

A Question is what a pending Action asks a Party, a Role, or a Worker before it resumes, kept on the Action with its answer.

A Question is what a Worker asks a Party during an Action, with choices or a schema, and its answer resumes the Action.

Properties

PropertyTypeRequiredDescription
toThingrequiredWho is asked: a Party such as the Customer or the caller, a Role, or a Worker.
texttextrequiredThe question, in one message.
choicesstring[]The answers offered, rendered as a picker; free text when absent.
schemajsonThe typed answer’s shape, rendered as form fields in the Portal.
answerBydatetimeAfter this, the Action’s timeout rule applies.
answerjsonThe answer given, with who gave it and through which Interface.
answeredAtdatetimeWhen the answer arrived; the Action resumes then.

Object

JSON
{
  "$id": "https://api.sb/petpantry.shop/questions/question_1",
  "$type": "Question",
  "to": "thing_1",
  "text": "Example text",
  "choices": [
    "Example choices"
  ],
  "schema": {},
  "answerBy": "2026-10-22T12:00:00Z",
  "answer": {},
  "answeredAt": "2026-10-22T12:00:00Z"
}

Relationships

  • A Question has one Action: a pending Action asks Questions and waits awaitingInput until each is answered or its deadline passes. action, inverse asks.
  • A Question is posted in one Thread: each Question posts in the Thread of the record it concerns, where free-text replies land. postedIn, inverse questions.

Verbs

  1. getReturns one Question by id.
    GET /{namespace}/questions/{id}readNo Event
  2. listReturns Questions, newest first, one page at a time.
    GET /{namespace}/questionsreadNo Event

A Question is kept forever and never edited: it has no update or delete.

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
Question.getYesYesYesYes
Question.listYesYesYesYes

Call it

Text
Show me the latest question.

Example

patentpad.com's drafting Agent asks a Customer which of two inventions to claim, with three choices and an answerBy two days out. The Customer taps one in the Portal, and the draft resumes.

Process.update

Previous Page

Question.get

Next Page