Quality Nominations API

The Quality Nominations API allows users to provide feedback on problem quality, suggest improvements, and report issues. Quality reviewers can then process these nominations.

Overview

The quality nomination system enables:

• Suggestions: Rate problem difficulty, quality, and tags
• Promotions: Nominate problems for quality status
• Demotions: Report problematic content
• Dismissals: Dismiss quality popups without feedback

Nomination Types

Endpoints

Create Nomination

Creates a new quality nomination.

POST /api/qualityNomination/create/

Parameters:

Suggestion Contents

{
  "difficulty": 2,
  "quality": 3,
  "tags": ["problemTopicDynamicProgramming", "problemTopicGraphTheory"],
  "before_ac": false
}

• difficulty: 0-4 scale (0=trivial, 4=very hard)
• quality: 0-4 scale (0=poor, 4=excellent)
• tags: Array of allowed topic tags
• before_ac: True if submitted before solving

Promotion Contents

{
  "statements": {
    "es": { "markdown": "# Problema\n\nDescripción..." },
    "en": { "markdown": "# Problem\n\nDescription..." }
  },
  "source": "Original problem by John Doe",
  "tags": ["problemTopicArrays", "problemTopicSorting"]
}

Demotion Contents

{
  "reason": "duplicate",
  "original": "original-problem-alias",
  "rationale": "This is a duplicate of the original problem."
}

Valid reasons: duplicate, no-problem-statement, offensive, other, spam, wrong-test-cases, poorly-described

Response:

{
  "qualitynomination_id": 12345
}

Privileges: Varies by nomination type (see above)

List Nominations

Returns a paginated list of nominations (reviewers only).

GET /api/qualityNomination/list/

Parameters:

Response:

{
  "nominations": [
    {
      "qualitynomination_id": 123,
      "problem": { "alias": "sum-two", "title": "Sum Two Numbers" },
      "nominator": { "username": "user1", "name": "User One" },
      "author": { "username": "author", "name": "Problem Author" },
      "nomination": "demotion",
      "status": "open",
      "time": { "time": 1609459200 },
      "contents": { "reason": "spam" },
      "votes": []
    }
  ],
  "pager_items": [...]
}

Privileges: Quality reviewer

My Nominations

Returns nominations created by the current user.

GET /api/qualityNomination/myList/

Parameters:

Privileges: Authenticated user

Assigned Nominations

Returns nominations assigned to the current reviewer.

GET /api/qualityNomination/myAssignedList/

Parameters:

Privileges: Quality reviewer

Get Nomination Details

Returns detailed information about a nomination.

GET /api/qualityNomination/details/

Parameters:

Response:

{
  "qualitynomination_id": 123,
  "nomination": "promotion",
  "nomination_status": "open",
  "time": { "time": 1609459200 },
  "problem": { "alias": "my-problem", "title": "My Problem" },
  "nominator": { "username": "user1", "name": "User One" },
  "author": { "username": "author", "name": "Author" },
  "contents": {
    "statements": {...},
    "source": "Original",
    "tags": [...]
  },
  "original_contents": {
    "statements": {...},
    "source": "Current source",
    "tags": [...]
  },
  "reviewer": true,
  "votes": []
}

Privileges: Nominator or Quality reviewer

Resolve Nomination

Resolves a demotion nomination (reviewers only).

POST /api/qualityNomination/resolve/

Parameters:

Response:

{
  "status": "ok"
}

Status Effects:

Privileges: Quality reviewer

Allowed Tags

Topic Tags (for suggestions/promotions)

• problemTopic2Sat
• problemTopicArrays
• problemTopicBinarySearch
• problemTopicDynamicProgramming
• problemTopicGraphTheory
• problemTopicGreedy
• ... (see full list in source)

Level Tags (for quality_tag)

• problemLevelBasicKarel
• problemLevelBasicIntroductionToProgramming
• problemLevelIntermediateDataStructuresAndAlgorithms
• problemLevelAdvancedCompetitiveProgramming
• ... (see full list in source)

Workflow

flowchart TD
    User[User Solves Problem] -->|Popup| Feedback{Provide Feedback?}
    Feedback -->|Yes| Suggestion[Submit Suggestion]
    Feedback -->|No| Dismiss[Dismiss]
    Feedback -->|Issue| Demotion[Submit Demotion]

    Suggestion --> Queue[Review Queue]
    Demotion --> Queue

    Queue --> Reviewer[Quality Reviewer]
    Reviewer -->|Demotion| Resolve{Resolve}
    Resolve -->|Ban| Banned[Problem Banned]
    Resolve -->|Warning| Warning[Problem Warning]
    Resolve -->|Dismiss| Resolved[Resolved]

Use Cases

Submit Quality Feedback

curl -X POST https://omegaup.com/api/qualityNomination/create/ \
  -d 'problem_alias=sum-two' \
  -d 'nomination=suggestion' \
  -d 'contents={"difficulty":1,"quality":3,"tags":["problemTopicArrays"]}'

Report Duplicate Problem

curl -X POST https://omegaup.com/api/qualityNomination/create/ \
  -d 'problem_alias=duplicate-problem' \
  -d 'nomination=demotion' \
  -d 'contents={"reason":"duplicate","original":"original-problem"}'

Related Documentation

• Problems API - Problem management
• Users API - User roles and permissions

Full Reference

For complete implementation and tag lists, see the QualityNomination Controller source code.