Quests
The Quest object
id - String
ID of the quest
name - String
Name of the quest
communityId - String
Your community ID
categoryId - String
Category (module) ID of the quest.
sprintId - String
Sprint ID of the quest
conditions - Array of object
List of conditions that define the user access to a quest. There are five types of conditions:
role
Compare a user discord role with the target value
Discord Role ID
=
, !=
quest
Compare the IDs of the quests a user completed with the target value
Quest ID
isCompleted
, isNotCompleted
date
Compare the current date with the target value
ISO string date
<
, >
nft
Check if a user hold a NFT
Number of NFT the user should hold
No operators
level
Compare a user level with the target value
Number
<
, >
twitterFollowers
Compare the number of twitter followers with the target value
Number
<
,>
conditionOperator - Enum (OR, AND)
This field defines the operator that is applied to link each condition. If it's AND, the user need to fulfill all the conditions to access the quest. If it's OR, fulfilling one condition is enough to access the quest.
recurrence - Enum (once, daily, weekly, monthly)
Defines how often a quest can be completed
retryAfter - Number
Number of seconds a user needs to wait after a quest has been failed
rewards - Array of objects
Rewards associated with a quest. There is 3 types of rewards:
role
Discord role
Discord role ID
xp
XP of the quest
Number
other
Custom reward
String
An optional reward method can be associated to a reward:
all
Default reward method
fcfs
First Come First Serve
{max: number, up to 1000}
raffle
Raffle
{amount: number, up to 1000}
tasks - Array of objects
This field contains the different tasks that compose the quest. You can learn more about the different types of tasks in our product documentation.
description - Object
TipTap document that describes the quest
autoValidate - Boolean
Boolean that defines if a quest requires a review or is automatically validated. The value of this field is automatically generated depending on the tasks that compose the quest.
deleted - Boolean
Defines if the quest is deleted
claimLimit - Number
Defines if the quest can be claimed a maximum number of times
archived - Boolean
Defines if the quest is archived
published - Boolean
Defines if the quest is visible for the members
API Reference
Last updated