Submit answers

Staging

https://testserver.loyi.io/public/api

POST

/quest/{id}/submit-answers

Submits user answers for the a quest of type quiz or
questionnaire. Sending this request again will re-evalute
the answers and update the status of the user's quiz.
Questionnaires always return a status of passed once the answers
have been submitted.

Request

Authorization

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "answers": [
        {
            "questionId": "12345678-1234-1234-1234-123456789012",
            "choiceId": "12345678-1234-1234-1234-123456789013"
        },
        {
            "questionId": "12345678-1234-1234-1234-123456789019",
            "value": "lorum ipsum dolor sit amet"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://testserver.loyi.io/public/api/quest//submit-answers' \
--header 'Origin: <WHITELISTED_URL>' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "answers": [
        {
            "questionId": "12345678-1234-1234-1234-123456789012",
            "choiceId": "12345678-1234-1234-1234-123456789013"
        },
        {
            "questionId": "12345678-1234-1234-1234-123456789019",
            "value": "lorum ipsum dolor sit amet"
        }
    ]
}'

Responses

🟢200OK

application/json

Body

Example

{
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "questId": "123e4567-e89b-12d3-a456-426614174000",
    "status": "passed",
    "submittedAt": "2022-01-01T00:00:00.000Z"
}

🟠400Bad Request

🟠401Unauthorized

Modified at 2025-08-08 11:37:21

Accept quest

Get answers