Storyden
Reports

Report Update

Update a report's status and optionally assign handler. Requires the `MANAGE_REPORTS` permission to set the status to anything other than closed. In other words, regular members can only close their own reports while "moderators" can acknowledge, assign and resolve reports.

Update a report's status and optionally assign handler. Requires the MANAGE_REPORTS permission to set the status to anything other than closed. In other words, regular members can only close their own reports while "moderators" can acknowledge, assign and resolve reports.

PATCH/reports/{report_id}

Authorization

storyden-session<token>

In: cookie

Path Parameters

report_idstring

Unique report ID.

Formatxid

Request Body

status?ReportStatus
Value in"submitted" | "acknowledged" | "resolved"
handled_by?Identifier

A unique identifier for this resource.

Formatxid

Response Body

curl -X PATCH "https://loading/api/reports/cc5lnd2s1s4652adtu50" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "cc5lnd2s1s4652adtu50",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "deletedAt": "2019-08-24T14:15:22Z",
  "misc": {},
  "target_id": "cc5lnd2s1s4652adtu50",
  "target_kind": "post",
  "reported_by": {
    "id": "cc5lnd2s1s4652adtu50",
    "joined": "2019-08-24T14:15:22Z",
    "suspended": "2019-08-24T14:15:22Z",
    "handle": "Southclaws",
    "name": "Barnaby Keene"
  },
  "handled_by": {
    "id": "cc5lnd2s1s4652adtu50",
    "joined": "2019-08-24T14:15:22Z",
    "suspended": "2019-08-24T14:15:22Z",
    "handle": "Southclaws",
    "name": "Barnaby Keene"
  },
  "comment": "string",
  "status": "submitted",
  "item": {
    "kind": "post",
    "ref": {
      "id": "cc5lnd2s1s4652adtu50",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "deletedAt": "2019-08-24T14:15:22Z",
      "misc": {},
      "title": "Hello world!",
      "description": "string",
      "slug": "cc5lnd2s1s4652adtu50-top-10-movies-thread",
      "author": {
        "id": "cc5lnd2s1s4652adtu50",
        "joined": "2019-08-24T14:15:22Z",
        "suspended": "2019-08-24T14:15:22Z",
        "handle": "Southclaws",
        "name": "Barnaby Keene"
      },
      "assets": [
        {
          "id": "cc5lnd2s1s4652adtu50",
          "filename": "string",
          "path": "string",
          "mime_type": "string",
          "width": 0,
          "height": 0,
          "parent": {
            "id": "cc5lnd2s1s4652adtu50",
            "filename": "string",
            "path": "string",
            "mime_type": "string",
            "width": 0,
            "height": 0,
            "parent": {}
          }
        }
      ],
      "reacts": [
        {
          "id": "cc5lnd2s1s4652adtu50",
          "emoji": "string",
          "author": {
            "id": "cc5lnd2s1s4652adtu50",
            "joined": "2019-08-24T14:15:22Z",
            "suspended": "2019-08-24T14:15:22Z",
            "handle": "Southclaws",
            "name": "Barnaby Keene"
          }
        }
      ],
      "collections": {
        "in_collections": 0,
        "has_collected": true
      },
      "likes": {
        "likes": 0,
        "liked": true
      },
      "meta": {},
      "body": "string",
      "body_links": [
        {
          "id": "cc5lnd2s1s4652adtu50",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "deletedAt": "2019-08-24T14:15:22Z",
          "misc": {},
          "url": "string",
          "slug": "github-com-southclaws-storyden",
          "domain": "github.com",
          "title": "The Open Graph Protocol",
          "description": "The Open Graph protocol enables any web page to become a rich object in a social graph.",
          "favicon_image": {
            "id": "cc5lnd2s1s4652adtu50",
            "filename": "string",
            "path": "string",
            "mime_type": "string",
            "width": 0,
            "height": 0,
            "parent": {
              "id": "cc5lnd2s1s4652adtu50",
              "filename": "string",
              "path": "string",
              "mime_type": "string",
              "width": 0,
              "height": 0,
              "parent": {}
            }
          },
          "primary_image": {
            "id": "cc5lnd2s1s4652adtu50",
            "filename": "string",
            "path": "string",
            "mime_type": "string",
            "width": 0,
            "height": 0,
            "parent": {
              "id": "cc5lnd2s1s4652adtu50",
              "filename": "string",
              "path": "string",
              "mime_type": "string",
              "width": 0,
              "height": 0,
              "parent": {}
            }
          }
        }
      ]
    }
  }
}
Empty
Empty
Empty
Empty
{
  "error": "string",
  "message": "string",
  "suggested": "string",
  "metadata": {}
}
Edit on GitHub

Report List GET GET

List reports. Regular members see only their own reports. Members with `MANAGE_REPORTS` permission will see all submitted reports. Reports can be filtered by status. By default filters open and acknowledged reports. Returns a list ordered by most recently updated.

Profile Followers Add PUT PUT

Follow the specified profile as the authenticated account.