Player Ratings

Use the shared API with the player's session and selected game server. Scores range from 1 to 5.

Available Questions

QuerydocumentId: pendingEvaluationsauth: Bearer session

pendingEvaluations

No variables are required. Returns [PlayerEvaluationInvitation!]!. An empty array means that no new questions are available.

Field	Type	Meaning
id	ID!	Invitation identifier to submit with the answer.
category	PlayerEvaluationCategory!	PROJECT, SERVER, SHOP or SUPPORT.
gameServerId	Int!	Game server associated with the question.
invitedAt	String!	UTC invitation timestamp in RFC 3339 format.

Request

{
  "documentId": "pendingEvaluations",
  "variables": {}
}

Response

{
  "data": {
    "pendingEvaluations": [
      {
        "id": "019a00a1-9876-7000-8000-000000000001",
        "category": "PROJECT",
        "gameServerId": 1,
        "invitedAt": "2026-09-18T12:00:00.000000Z"
      }
    ]
  }
}

Submit Ratings

MutationdocumentId: answerEvaluationsauth: Bearer session

answerEvaluations

Field	Type	Conditions
input	AnswerEvaluationsInput!	Required object.
input.answers	[PlayerEvaluationAnswerInput!]!	Between 1 and 4 answers.
input.answers[].invitationId	ID!	UUID from pendingEvaluations, unique within the request.
input.answers[].score	Int!	Integer from 1 to 5.

Returns [PlayerEvaluationAnswer!]!. Each answer contains invitationId: ID!, score: Int! and answeredAt: String!, a UTC RFC 3339 timestamp. Answering only some questions is allowed. A submitted score cannot be changed. Repeating the same answer returns the saved result.

Request

{
  "documentId": "answerEvaluations",
  "variables": {
    "input": {
      "answers": [
        {
          "invitationId": "019a00a1-9876-7000-8000-000000000001",
          "score": 5
        }
      ]
    }
  }
}

Response

{
  "data": {
    "answerEvaluations": [
      {
        "invitationId": "019a00a1-9876-7000-8000-000000000001",
        "score": 5,
        "answeredAt": "2026-09-18T12:05:00.000000Z"
      }
    ]
  }
}

Errors

• UNAUTHENTICATED: restore the player's session.
• SERVER_REQUIRED: select a game server and repeat the request.
• EVALUATION_UNAVAILABLE: refresh the available questions.
• EVALUATION_ALREADY_ANSWERED: the saved score cannot be replaced.

Field value errors are returned in errors[].extensions.validation. Correct the indicated answer fields. GraphQL type mismatches, such as a string instead of an integer, are returned in errors[].message.

See the error reference for the response format.