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:

Type
Description
Value
Operators

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:

Type
Description
Value

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:

Reward method type
Description
Settings

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