Skip to main content

Create a new quest

POST 

/quests

This endpoint creates a new quest

Request

Body

required

Quest to be created

    name stringrequired

    a unique name for the quest

    owner stringrequired

    the primary owner of the quest, an id from the buddy-auth service (e.g. GET /user)

    image stringrequired

    a unique name for the quest

    displayName stringrequired

    a vanity name for the quest

    status stringrequired

    Possible values: [active, inactive]

    the status of the quest

    config

    object

    required

    pointValue integerrequired

    the number of points the quest is worth

    repeatFrequency stringrequired

    Possible values: [none, hourly, daily, weekly, monthly, yearly]

    how often the quest can be repeated

    MaximumTimeToComplete integerrequired

    the maximum time to complete the quest in hours

    useLastSuccessAsEpoch booleanrequired

    whether to use the last success as the epoch for the next repeat

    timezone stringrequired

    offset from UTC e.g. -07:00

    repeatLimit integerrequired

    the number of times the quest can be repeated, 0 for unlimited

    trigger

    object

    type stringrequired

    the type of trigger (e.g. webhook, cron, social)

    provider stringrequired

    the provider of the trigger (e.g. twitter, github, cron)

    args objectrequired

    the arguments for the trigger, see documentation for each provider

Responses

Quest created

Schema

    name stringrequired

    a unique name for the quest

    owner stringrequired

    the primary owner of the quest, an id from the buddy-auth service (e.g. GET /user)

    image stringrequired

    a unique name for the quest

    displayName stringrequired

    a vanity name for the quest

    status stringrequired

    Possible values: [active, inactive]

    the status of the quest

    config

    object

    required

    pointValue integerrequired

    the number of points the quest is worth

    repeatFrequency stringrequired

    Possible values: [none, hourly, daily, weekly, monthly, yearly]

    how often the quest can be repeated

    MaximumTimeToComplete integerrequired

    the maximum time to complete the quest in hours

    useLastSuccessAsEpoch booleanrequired

    whether to use the last success as the epoch for the next repeat

    timezone stringrequired

    offset from UTC e.g. -07:00

    repeatLimit integerrequired

    the number of times the quest can be repeated, 0 for unlimited

    trigger

    object

    type stringrequired

    the type of trigger (e.g. webhook, cron, social)

    provider stringrequired

    the provider of the trigger (e.g. twitter, github, cron)

    args objectrequired

    the arguments for the trigger, see documentation for each provider

Loading...