Questions
What is still unknown about the brand.
Privacy and analytics
We use necessary technical cookies and, only with your consent, analytics and marketing pixels to improve the website and measure campaigns.
Privacy and analytics
We use necessary technical cookies and, only with your consent, analytics and marketing pixels to improve the website and measure campaigns.
What is still unknown about the brand.
Updated on January 1, 1970
Questions the brand still has to answer, for the Genome, the Kit or a work. Read-only: it never syncs or rewrites anything.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/questions.list |
| MCP tool | questions_list |
| Scope | questions.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Nödo, Voice, MCP, API, Chat, Screens, Apps |
| Status | Available |
| Widget | list |
Input
{
scope?: "genome" | "brand_kit" | "work" | "all" // default "all"
cursor?: string // ≤ 512 · Opaque cursor from a previous `nextCursor`.
limit?: integer // 1–50 · default 20
}Output
{
items: Array<{
id: string // uuid
question: string
scope: string
options: string[]
revision: integer // -9007199254740991–9007199254740991
}>
nextCursor: string | null
}Asks the brand up to 5 questions with options plus a free answer when information is missing. Use it instead of guessing.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/questions.ask |
| MCP tool | questions_ask |
| Scope | questions.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Nödo, Chat, Screens, Apps |
| Status | Available |
Input
{
questions: Array<{
key: string // ≤ 80
question: string // ≤ 300
options: string[] // ≤ 6 items
scope: "genome" | "brand_kit" | "work"
}> // ≤ 5 items
}Output
{
ok: true
ids: string[]
}Answers, defers or dismisses one question. An answer becomes an accepted brand declaration in memory.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/questions.answer |
| MCP tool | questions_answer |
| Scope | questions.write |
| Minimum role | Admin |
| Human confirmation | No |
| Doors | Nödo, MCP, API, Chat, Screens, Apps |
| Status | Available |
Input
{
questionId: string // uuid
expectedRevision: integer // -9007199254740991–9007199254740991
action: "answer" | "defer" | "dismiss"
answer?: string // ≤ 2000
idempotencyKey: string // ≤ 80
}Output
{
ok: true
id?: string
revision?: integer // -9007199254740991–9007199254740991
}Resolves one brand question with the structured answer of the screen (text, option values, a file or colours), or defers or dismisses it. Idempotent per idempotencyKey; returns the new revision and how many brand questions remain pending.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/questions.resolve |
| MCP tool | questions_resolve |
| Scope | questions.write |
| Minimum role | Admin |
| Human confirmation | No |
| Doors | API, MCP, Screens, Apps, Nödo |
| Status | Available |
Input
{
questionId: string // uuid
expectedRevision: integer // –9007199254740991
idempotencyKey: string // uuid
action: "answer" | "defer" | "dismiss"
answer?: {
text?: string // ≤ 4000
values?: string[] // ≤ 30 items
assetId?: string // uuid
colors?: string[] // ≤ 12 items
}
reason?: string // ≤ 1000
}Output
{
id: string // uuid
revision: integer // -9007199254740991–9007199254740991
pending: integer | null
}