File Report

curl --request POST \
  --url https://api.member.dev/api/v1/hubs/{hub_id}/reports \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '
{
  "data": {
    "attributes": {
      "reportable_id": "<string>",
      "reportable_type": "<string>",
      "notes": "<string>",
      "reason_id": "<string>"
    },
    "type": "moderation_reports"
  }
}
'

{
  "data": {
    "attributes": {
      "created_at": "2023-11-07T05:31:56Z",
      "notes": "<string>",
      "reason_id": "<string>",
      "reportable_id": "<string>",
      "reportable_type": "<string>",
      "resolution": "<string>",
      "resolved_at": "2023-11-07T05:31:56Z",
      "status": "<string>"
    },
    "id": "<string>",
    "type": "moderation_reports"
  }
}

community-moderation

File Report

File a moderation report against a community entity.

Validates membership, prevents self-reports, and enforces a 24-hour duplicate guard.

Returns 201 Created with the new report on success. Returns 403 when the hub does not exist, the reporter is not a hub member, or the reporter is banned/soft-banned. All three cases return an identical response body so that hub IDs cannot be enumerated. Returns 422 when the report fails validation (self-report, duplicate, etc.). Returns 501 when reportable_type=‘message’ (not yet supported).

Security (R2.I1): hub-existence resolution happens INSIDE the route body using _err(), not via a Depends() that raises HTTPException. This ensures the “hub missing” 403 and the “not a member” 403 go through the same code path and produce byte-identical response bodies, preventing hub enumeration.

POST

api

hubs

{hub_id}

reports

File Report

curl --request POST \
  --url https://api.member.dev/api/v1/hubs/{hub_id}/reports \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '
{
  "data": {
    "attributes": {
      "reportable_id": "<string>",
      "reportable_type": "<string>",
      "notes": "<string>",
      "reason_id": "<string>"
    },
    "type": "moderation_reports"
  }
}
'

{
  "data": {
    "attributes": {
      "created_at": "2023-11-07T05:31:56Z",
      "notes": "<string>",
      "reason_id": "<string>",
      "reportable_id": "<string>",
      "reportable_type": "<string>",
      "resolution": "<string>",
      "resolved_at": "2023-11-07T05:31:56Z",
      "status": "<string>"
    },
    "id": "<string>",
    "type": "moderation_reports"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

hub_id

string

required

Body

application/vnd.api+json

data

FileReportData · object

required

Show child attributes

Response

Successful Response

data

ModerationReportResource · object

required

Show child attributes

Portal Get Anon Page Render Search Community

⌘I