Create Quest mnemons: a header (status, kind, playersCanTick, hook, and giverId / locationId / parentQuestId links) and a body of objectives (with sub-objectives), reward chips, a Markdown background and GM-only gmNotes. The server builds the quest the Argo app shows from these. Do not write objectives or rewards as Markdown; markdown alone becomes the Background. The retired quest board fields (steps, reward rows, issuer*, questStatus) are for quests the migration has not converted — see describe_mnemon_types.questBody. Players may not call this — GM/co-GM only.
View input schema
{
"type": "object",
"properties": {
"campaignId": {
"type": "string",
"minLength": 1
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"description": "Title of the new entry."
},
"markdown": {
"type": "string",
"minLength": 1,
"description": "The quest's prose in Markdown: its Background when background is not given. Mentions: @[label](mnemon:<entryId>)."
},
"visibility": {
"type": "string",
"enum": [
"HIDDEN",
"INTERNAL",
"PUBLIC"
]
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"status": {
"type": "string",
"enum": [
"Available",
"Active",
"Completed",
"Failed"
],
"description": "Available | Active | Completed | Failed. Reads as Available when unset."
},
"kind": {
"type": "string",
"enum": [
"Main",
"Side",
"Personal"
],
"description": "Main | Side | Personal. Reads as Side when unset."
},
"playersCanTick": {
"type": "boolean",
"description": "Whether players may tick the objectives they can see. Off by default."
},
"hook": {
"type": "string",
"description": "The one line players see under the title in the quest log. An empty string clears it."
},
"giverId": {
"type": "string",
"description": "Who gives the quest: an NPC's entryId or exact title (its Quest giver link). On update an empty string removes it."
},
"locationId": {
"type": "string",
"description": "Where the quest is given or set: a Location's entryId or exact title. On update an empty string removes it."
},
"parentQuestId": {
"type": "string",
"description": "The quest this one belongs to: a Quest's entryId or exact title. On update an empty string removes it."
},
"objectives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The objective to rewrite, as get_mnemon's quest.objectives[].id names it. Omit for a new objective."
},
"text": {
"type": "string",
"minLength": 1,
"description": "The objective, one line of Markdown. Mentions: @[label](mnemon:<entryId>)."
},
"state": {
"type": "string",
"enum": [
"open",
"done",
"failed"
],
"description": "open (the default), done or failed."
},
"optional": {
"type": "boolean",
"description": "An optional objective does not count toward the quest's progress. Defaults to false."
},
"hidden": {
"type": "boolean",
"description": "true hides it from players, false shows it; omitted keeps what it has (a new one is shown)."
},
"children": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The objective to rewrite, as get_mnemon's quest.objectives[].id names it. Omit for a new objective."
},
"text": {
"type": "string",
"minLength": 1,
"description": "The objective, one line of Markdown. Mentions: @[label](mnemon:<entryId>)."
},
"state": {
"type": "string",
"enum": [
"open",
"done",
"failed"
],
"description": "open (the default), done or failed."
},
"optional": {
"type": "boolean",
"description": "An optional objective does not count toward the quest's progress. Defaults to false."
},
"hidden": {
"type": "boolean",
"description": "true hides it from players, false shows it; omitted keeps what it has (a new one is shown)."
}
},
"required": [
"text"
],
"additionalProperties": false
},
"description": "Its sub-objectives, in order. Omitted keeps the ones it has; an empty list removes them."
}
},
"required": [
"text"
],
"additionalProperties": false
},
"description": "The objectives, in order."
},
"rewards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The chip to rewrite, as get_mnemon's quest.rewards[].id names it. Omit for a new chip."
},
"kind": {
"type": "string",
"enum": [
"currency",
"xp",
"item",
"other"
],
"description": "currency | xp | item | other. Makes this a reward chip — send it on every reward."
},
"amount": {
"type": "number",
"description": "How many: coins, experience points, a stack."
},
"unit": {
"type": "string",
"description": "currency chips: the coin, as the campaign's setting names it (e.g. coin.gp), or free text such as 'gold'."
},
"unitLabel": {
"type": "string",
"description": "How the coin reads, e.g. 'Gold piece'."
},
"label": {
"type": "string",
"description": "What the chip says: an item's name, a favour, a title."
},
"entryId": {
"type": "string",
"description": "item chips: the mnemon entry it links to (entryId or exact title). Not with ruleEntryId."
},
"ruleEntryId": {
"type": "string",
"description": "item chips: the rules-library entry it links to. Not with entryId."
},
"hidden": {
"type": "boolean",
"description": "true hides the chip from players, false shows it; omitted keeps what it has (a new one is shown)."
},
"rewardType": {
"type": "string",
"description": "Retired reward row, without kind: Gold | Item | XP | Reputation …"
},
"itemId": {
"type": "string",
"description": "Retired reward row: a free-text item reference."
},
"notes": {
"type": "string",
"description": "Retired reward row: notes."
},
"linkedStepIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Retired reward row: the stepIds or subquest entry ids that unlock it."
}
},
"additionalProperties": false
},
"description": "The reward chips, each with its kind."
},
"background": {
"type": "string",
"description": "The Background section, in Markdown."
},
"gmNotes": {
"type": "string",
"description": "GM-only notes, in Markdown. Players never see them."
},
"subQuestEntryIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "This quest's subquests (entryIds or titles). Prefer parentQuestId on each subquest."
},
"relatedNpcEntryIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "NPCs the quest involves (entryIds or titles)."
},
"relatedLocationEntryIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Locations the quest involves (entryIds or titles)."
},
"questStatus": {
"type": "string",
"description": "Retired: send status."
},
"issuerNpcEntryId": {
"type": "string",
"description": "Retired quest board field: send giverId."
},
"issuerText": {
"type": "string",
"description": "Retired quest board field: write it into background."
},
"repeatable": {
"type": "boolean",
"description": "Retired quest board field."
},
"expiresAt": {
"type": "string",
"description": "Retired quest board field (ISO-8601)."
},
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"stepId": {
"type": "string",
"description": "Optional. Server generates a fresh UUID when blank. Provide an existing stepId to reuse linkedStepIds."
},
"title": {
"type": "string",
"description": "Short label for the step, e.g. 'Talk to the innkeeper'."
},
"description": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"Hidden",
"Available",
"Active",
"Completed",
"Failed",
"TurnedIn",
"Abandoned",
"Expired",
"OnHold"
],
"description": "Defaults to 'Available' when omitted. Unknown values are coerced server-side."
},
"targetNpcEntryIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "NPCs involved in this step (entryIds or titles)."
},
"targetLocationEntryIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Locations involved in this step."
},
"notes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Free-text bullet notes for the step."
}
},
"required": [
"title"
],
"additionalProperties": false
},
"description": "Retired: the old quest board's steps, for quests the migration has not converted. Send objectives."
}
},
"required": [
"title"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 50
}
},
"required": [
"campaignId",
"items"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}