Abuse and reporting

Abusive apps, users and websites may be reported to Marketplace staff. It can also be used to signal issues about the corresponding listing on Marketplace.

Note

Authentication is optional for abuse reports.

Note

These endpoints are rate-limited at 30 requests per hour per user.

Report An Abusive App

POST /api/v2/abuse/app/

Report an abusive app to Marketplace staff.

Request

Parameters:
  • text (string) – a textual description of the abuse
  • app (int|string) – the app id or slug of the app being reported
 
{
    "sprout": "potato",
    "text": "There is a problem with this app.",
    "app": 2
}

This endpoint uses PotatoCaptcha, so there must be a field named sprout with the value potato and cannot be a field named tuber with a truthy value.

Response

{
    "reporter": null,
    "text": "There is a problem with this app.",
    "app": {
        "id": 2,
        "name": "cvan's app",
        "...": "more info"
    }
}
Status Codes:

Report An Abusive User

POST /api/v2/abuse/user/

Report an abusive user to Marketplace staff.

Request

Parameters:
  • text (string) – a textual description of the abuse
  • user (int) – the primary key of the user being reported
 
{
    "sprout": "potato",
    "text": "There is a problem with this user",
    "user": 27
}

This endpoint uses PotatoCaptcha, so there must be a field named sprout with the value potato and cannot be a field named tuber with a truthy value.

Response

{
    "reporter": null,
    "text": "There is a problem with this user.",
    "user": {
        "display_name": "cvan",
        "resource_uri": "/api/v2/account/settings/27/"
    }
}
Status Codes:

Report A Website

POST /api/v2/abuse/website/

Report an issue with a website to Marketplace staff.

Request

Parameters:
  • text (string) – a textual description of the issue
  • app (int) – the id of the website being reported
 
{
    "sprout": "potato",
    "text": "There is a problem with this site.",
    "website": 42
}

This endpoint uses PotatoCaptcha, so there must be a field named sprout with the value potato and cannot be a field named tuber with a truthy value.

Response

{
    "reporter": null,
    "text": "There is a problem with this app.",
    "website": {
        "id": 42,
        "name": "cvan's site",
        "...": "more info"
    }
}
Status Codes: