---
title: "Create a report"
method: POST
path: "/v1/reports"
tags: ["Reports"]
---

# Create a report

`POST /v1/reports`

## Request

- Base URL: `https://api.momentum-mod.org` (the document declares no server; this is the origin it was published from)
- URL: `https://api.momentum-mod.org/v1/reports`
- Auth: HTTP bearer

## Request body

- CreateReportDto
  - `data` number, required: The ID of the object being referred to by the report
  - `type` 0 | 1 | 2, required: The type of the report
  - `category` 0 | 1 | 2 | 3, required: The category of the report
  - `message` string, required: The main text of the report

## Response `200`

The newly created report

- ReportDto
  - `id` number, required
  - `data` number, required: The ID of the object being referred to by the report
  - `type` 0 | 1 | 2, required: The type of the report
  - `category` 0 | 1 | 2 | 3, required: The category of the report
  - `message` string, required: The main text of the report
  - `resolved` boolean, required: Whether the report has been resolved or not
  - `resolutionMessage` string: The reason the report was resolved, if it was
  - `submitterID` number, required: The user ID of the submitter
  - `submitter` UserDto
    - `id` number, required: The unique numeric ID of the user
    - `steamID` string, required: The Steam community ID (i.e. the uint64 format, not STEAM:...) of the user
    - `alias` string, required: The user's alias, which is either a current or previous Steam name, or something they set themselves
    - `country` string: Two-letter (ISO 3166-1 Alpha-2) country code for the user
    - `avatarURL` string, required
    - `profile` ProfileDto
      - `userID` number, required: The ID of the user
      - `bio` string, required: The text-based bio of the user
      - `socials` SocialsDto
        - `Discord` string, required: Discord Username
        - `Github` string, required: Github Username
        - `Instagram` string, required: Instagram Username
        - `Ko-fi` string, required: Ko-fi Username
        - `LinkedIn` string, required: LinkedIn Username
        - `Mastodon` string, required: Mastodon Username
        - `Patreon` string, required: Patreon Username
        - `Paypal` string, required: Paypal Username
        - `Spotify` string, required: Spotify Username
        - `Twitch` string, required: Twitch Username
        - `Twitter` string, required: Twitter Username
        - `YouTube` string, required: YouTube Username
    - `userStats` UserStatsDto
      - `cosXP` number, required: The user's total cosmetic XP
      - `level` number, required: The user's level
      - `mapsCompleted` number, required: Total maps completed
      - `runsSubmitted` number, required: Total runs submitted
      - `totalJumps` number, required: The user's total number of jumps
      - `totalStrafes` number, required: The user's total number of strafes
    - `roles` number, required: Flags of user's roles
    - `bans` number, required: Flags of user's bans
    - `createdAt` string, required: When the item was first created, as ISO8601 date string
  - `resolverID` number: The user ID of the resolver, if its been resolved
  - `resolver` UserDto
    - `id` number, required: The unique numeric ID of the user
    - `steamID` string, required: The Steam community ID (i.e. the uint64 format, not STEAM:...) of the user
    - `alias` string, required: The user's alias, which is either a current or previous Steam name, or something they set themselves
    - `country` string: Two-letter (ISO 3166-1 Alpha-2) country code for the user
    - `avatarURL` string, required
    - `profile` ProfileDto
      - `userID` number, required: The ID of the user
      - `bio` string, required: The text-based bio of the user
      - `socials` SocialsDto
        - `Discord` string, required: Discord Username
        - `Github` string, required: Github Username
        - `Instagram` string, required: Instagram Username
        - `Ko-fi` string, required: Ko-fi Username
        - `LinkedIn` string, required: LinkedIn Username
        - `Mastodon` string, required: Mastodon Username
        - `Patreon` string, required: Patreon Username
        - `Paypal` string, required: Paypal Username
        - `Spotify` string, required: Spotify Username
        - `Twitch` string, required: Twitch Username
        - `Twitter` string, required: Twitter Username
        - `YouTube` string, required: YouTube Username
    - `userStats` UserStatsDto
      - `cosXP` number, required: The user's total cosmetic XP
      - `level` number, required: The user's level
      - `mapsCompleted` number, required: Total maps completed
      - `runsSubmitted` number, required: Total runs submitted
      - `totalJumps` number, required: The user's total number of jumps
      - `totalStrafes` number, required: The user's total number of strafes
    - `roles` number, required: Flags of user's roles
    - `bans` number, required: Flags of user's bans
    - `createdAt` string, required: When the item was first created, as ISO8601 date string
  - `createdAt` string, required: When the item was first created, as ISO8601 date string
  - `updatedAt` string, required: When the item was last modified, as ISO8601 date string

---

[API](https://skmtc.dev/momentum-mod/apis/momentum-mod-api.md) - [All operations](https://skmtc.dev/momentum-mod/apis/momentum-mod-api/llms.txt) - [OpenAPI document](https://skmtc.dev/momentum-mod/apis/momentum-mod-api/revisions/0a88cfbbcc65?raw)
