Update a quest

PUT 
https://api.playmakers.co/quest/:questId

Update a quest

Request

Path Parameters

questId questIdrequired

The questId to update

application/json

Body

Quest data

prerequisites questId (string)[]nullable
description string

Possible values: <= 3000 characters

data string

Possible values: >= 2 characters

periodic stringnullable
refereeQuestId stringnullable
thumbnail urlnullable
state stringnullable
points integer

Possible values: <= 1000000

name questName (string)

Possible values: <= 64 characters

Name of the quest

userQuestsLimit integernullable

Responses

200

Quest successfully updated

application/json

Schema

Schema

userQuestCount integer

Number of times this quest has been completed.

userQuestsLimit integer

Maximum allowed number of times for the quest to be completed by a single user

name questName (string)required

Possible values: <= 64 characters

Name of the quest

id questId (string)

Unique identifier for Quest

projectId projectId (string)required

Unique identifier for Project

expiresAt date-timenullable

Expiration date for the quest

referrerQuestId string

Unique identifier for the referrer quest

thumbnail stringnullable

URL to the quest's thumbnail image

descriptions string

Detailed descriptions of the different stages/applications of the quest

points integerrequired

Possible values: <= 1000000

The amount of points you gain after finishing the quest

state questState (string)

Possible values: [open, closed]

periodic questPeriodic (string)

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

refereeQuestId stringnullable

Unique identifier for the referee quest

data string

Quest-specific data in JSON format

createdAt date-time

Time representation of entity creation

prerequisites questId (string)[]nullable

List of prerequisite quests that must be completed before starting this quest

myUserQuestCount integer

Number of times this quest has been completed by the current user

questTypeId stringrequired

Unique identifier for the QuestType

rankOrder integer

The order in which the quest should be displayed

Example (from schema)

{
  "userQuestCount": 1,
  "userQuestsLimit": 3,
  "name": "Game referral",
  "id": "q3b19Z1n",
  "projectId": "p2Duhf5N6",
  "expiresAt": "2025-01-01T09:00:00.00Z",
  "referrerQuestId": "Q3b19Z1n",
  "thumbnail": "https://file.playmakers.co/p2Duhf5N6/aUv0OhmsR.jpg",
  "descriptions": "{\"short\":\"wishlist BF4 in order to obtain your points\",\"pre\":[\"stage 1 desc\",\"stage 2 desc\"]}",
  "points": 50,
  "state": "open",
  "periodic": "daily",
  "refereeQuestId": "Q3b19Z1n",
  "data": "string",
  "createdAt": "2024-01-01T09:00:00.00Z",
  "prerequisites": [
    "q3b19Z1n"
  ],
  "myUserQuestCount": 2,
  "questTypeId": "Q3b19Z1n",
  "rankOrder": 1
}

401

Unauthorized

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "Unauthorized access"
}

403

Forbidden

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "Forbidden access"
}

404

NotFound

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "A mandatory item was not found"
}

500

Internal Server Error

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "Internal Server Error"
}

default

Unexpected error

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "An unexpected error occured"
}

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X PUT 'https://api.playmakers.co/quest/:questId' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "prerequisites": [
    "q3b19Z1n"
  ],
  "description": "string",
  "data": "string",
  "periodic": "string",
  "refereeQuestId": "string",
  "thumbnail": "https://file.playmakers.co/q2Duhf5N6/thumbnail.jpg",
  "state": "string",
  "points": 0,
  "name": "Game referral",
  "userQuestsLimit": 0
}'

Request Collapse all

Base URL

https://api.playmakers.co

Auth

Bearer Token

Parameters

questId — pathrequired

Body

{
  "prerequisites": [
    "q3b19Z1n"
  ],
  "description": "string",
  "data": "string",
  "periodic": "string",
  "refereeQuestId": "string",
  "thumbnail": "https://file.playmakers.co/q2Duhf5N6/thumbnail.jpg",
  "state": "string",
  "points": 0,
  "name": "Game referral",
  "userQuestsLimit": 0
}

ResponseClear

Click the Send API Request button above and see the response here!