Skip to content
Developer

Social Reports

Media4 EndpointsMedia / Social Reports

Returns a list of content reports (admin only)

GET/api/media/social_report

Query parameters

idinteger
deletedbooleanThis property is used to mark an entity as deleted / archived | Default value: false
socialPoststring
commentstring
socialProfilestringThe reporting member.
createdstring
updatedstring
searchStringstringtext to search for in the list
orderFieldNamestringname of the order field
orderFieldSortstringsorting modeAllowed: DESCASC
pageintegerpage of the list
pageSizeintegernumber of entries for each page
withMaxPageNumberstringreturns the number of pages available as a header if this is set

Responses

200Returns a list of MediaSocialReport objectsarray<MediaSocialReport>

Show fields (8)
  • idinteger

    Primary key of the social report. Internal ID.

  • reasonstring

    Free-text reason given by the reporter. Optional.

  • social_postMediaSocialPost10

    Reported post.

    Show fields (15)
    • url_imagestring

      Proxy URL that resolves to this post's image. Returns null until a preview has been extracted and an imageToken is assigned.

    • idinteger

      Primary key of the social post. Internal ID.

    • headlinestring

      Headline of the post.

    • textstring

      Text of the post.

    • urlstring

      Link in the post.

    • url_titlestring

      Title of the link in the post.

    • url_source_imagestring

      Raw origin URL of the preview image. Stored as scope-only; never exposed directly to non-admin callers — use the virtual url_image property instead.

    • image_tokenstring

      Server-assigned, never accepted from API input — omitted from oaInput groups on purpose.

    • moderation_statusstring

      Moderation status, for example pending or approved.

    • moderated_manuallyboolean

      True once a moderator decided about this entry by hand. Automatic decisions - a trigger match on creation, the batch auto-approve - leave it false, and that is what lets member reports push an entry back into moderation later on.

    • report_countinteger

      Number of distinct members who reported this entry. Moderators only.

    • social_profileMediaSocialProfile10

      Profile that wrote the post.

    • createdstring (date-time)

      Point in time the entity was created.

    • updatedstring (date-time)

      Point in time the entity was last updated.

    • deletedboolean

      This property is used to mark an entity as deleted / archived

  • commentMediaSocialPostComment4

    Reported comment.

    Show fields (10)
    • idinteger

      Primary key of the social post comment. Internal ID.

    • textstring

      Text of the comment.

    • urlstring

      Link in the comment.

    • moderation_statusstring

      Moderation status, for example pending or approved.

    • moderated_manuallyboolean

      True once a moderator decided about this entry by hand. Automatic decisions - a trigger match on creation, the batch auto-approve - leave it false, and that is what lets member reports push an entry back into moderation later on.

    • report_countinteger

      Number of distinct members who reported this entry. Moderators only.

    • social_profileMediaSocialProfile10

      Profile that wrote the comment.

    • createdstring (date-time)

      Point in time the entity was created.

    • updatedstring (date-time)

      Point in time the entity was last updated.

    • deletedboolean

      This property is used to mark an entity as deleted / archived

  • social_profileMediaSocialProfile10

    The reporting member.

    Show fields (11)
    • idinteger

      Primary key of the social profile. Internal ID.

    • public_namestring

      Name shown publicly.

    • profile_picture_urlstring

      URL of the profile picture.

    • public_about_mestring

      Text about the person shown publicly.

    • global_profileboolean

      The profile is a global profile across installations.

    • name_display_typestring

      How the name is shown, for example full name or first name only.

    • show_profile_pictureboolean

      The profile picture is shown.

    • profile_picture_check_statusstring

      Pruefstatus des Profilbilds (KI-Pruefung, siehe MediaSocialProfilePictureHelper): null = nie geprueft (Pruefung aus), pending, approved, rejected. Nur ein freigegebenes Bild landet in profilePictureUrl, solange die Pruefung eingeschaltet ist.

    • createdstring (date-time)

      Point in time the entity was created.

    • updatedstring (date-time)

      Point in time the entity was last updated.

    • deletedboolean

      This property is used to mark an entity as deleted / archived

  • createdstring (date-time)

    Point in time the entity was created.

  • updatedstring (date-time)

    Point in time the entity was last updated.

  • deletedboolean

    This property is used to mark an entity as deleted / archived

Request
curl --request GET \
  --url https://your-instance.iw-erp.de/api/media/social_report \
  --header 'x-iw-jwt-token: <TOKEN>'
Response 200 application/json
[
  {
    "id": 42,
    "comment": {
      "id": 42,
      "text": "Text",
      "url": "https://vynst.de",
      "moderation_status": "string",
      "moderated_manually": true,
      "report_count": 1,
      "created": "2026-10-15T09:30:00+02:00",
      "updated": "2026-10-15T09:30:00+02:00",
      "deleted": true
    },
    "reason": "string",
    "social_post": {
      "id": 42,
      "text": "Text",
      "url": "https://vynst.de",
      "url_title": "Beispiel",
      "url_image": "string",
      "headline": "string",
      "url_source_image": "string",
      "image_token": "string",
      "moderation_status": "string",
      "moderated_manually": true
    },
    "social_profile": {
      "id": 42,
      "public_name": "Beispiel",
      "profile_picture_url": "https://vynst.de",
      "public_about_me": "string",
      "global_profile": true,
      "name_display_type": "string",
      "show_profile_picture": true,
      "profile_picture_check_status": "string",
      "created": "2026-10-15T09:30:00+02:00",
      "updated": "2026-10-15T09:30:00+02:00"
    },
    "created": "2026-10-15T09:30:00+02:00",
    "updated": "2026-10-15T09:30:00+02:00",
    "deleted": true
  }
]

A member reports a post or a comment.

POST/api/media/social_report/user

Exactly one of socialPost / comment must be given. Content a moderator already decided about by hand cannot be reported. Once enough different members have reported the same content, it goes back into moderation.

Request body application/json

  • dataMediaSocialReport2
    Show fields (4)
    • reasonstring

      Free-text reason given by the reporter. Optional.

    • social_postMediaSocialPost6

      Reported post.

    • commentMediaSocialPostComment5

      Reported comment.

    • deletedboolean

      This property is used to mark an entity as deleted / archived

Responses

200Member reports a post or a commentMediaSocialReport

Show fields (8)
  • idinteger

    Primary key of the social report. Internal ID.

  • reasonstring

    Free-text reason given by the reporter. Optional.

  • social_postMediaSocialPost10

    Reported post.

    Show fields (15)
    • url_imagestring

      Proxy URL that resolves to this post's image. Returns null until a preview has been extracted and an imageToken is assigned.

    • idinteger

      Primary key of the social post. Internal ID.

    • headlinestring

      Headline of the post.

    • textstring

      Text of the post.

    • urlstring

      Link in the post.

    • url_titlestring

      Title of the link in the post.

    • url_source_imagestring

      Raw origin URL of the preview image. Stored as scope-only; never exposed directly to non-admin callers — use the virtual url_image property instead.

    • image_tokenstring

      Server-assigned, never accepted from API input — omitted from oaInput groups on purpose.

    • moderation_statusstring

      Moderation status, for example pending or approved.

    • moderated_manuallyboolean

      True once a moderator decided about this entry by hand. Automatic decisions - a trigger match on creation, the batch auto-approve - leave it false, and that is what lets member reports push an entry back into moderation later on.

    • report_countinteger

      Number of distinct members who reported this entry. Moderators only.

    • social_profileMediaSocialProfile10

      Profile that wrote the post.

    • createdstring (date-time)

      Point in time the entity was created.

    • updatedstring (date-time)

      Point in time the entity was last updated.

    • deletedboolean

      This property is used to mark an entity as deleted / archived

  • commentMediaSocialPostComment4

    Reported comment.

    Show fields (10)
    • idinteger

      Primary key of the social post comment. Internal ID.

    • textstring

      Text of the comment.

    • urlstring

      Link in the comment.

    • moderation_statusstring

      Moderation status, for example pending or approved.

    • moderated_manuallyboolean

      True once a moderator decided about this entry by hand. Automatic decisions - a trigger match on creation, the batch auto-approve - leave it false, and that is what lets member reports push an entry back into moderation later on.

    • report_countinteger

      Number of distinct members who reported this entry. Moderators only.

    • social_profileMediaSocialProfile10

      Profile that wrote the comment.

    • createdstring (date-time)

      Point in time the entity was created.

    • updatedstring (date-time)

      Point in time the entity was last updated.

    • deletedboolean

      This property is used to mark an entity as deleted / archived

  • social_profileMediaSocialProfile10

    The reporting member.

    Show fields (11)
    • idinteger

      Primary key of the social profile. Internal ID.

    • public_namestring

      Name shown publicly.

    • profile_picture_urlstring

      URL of the profile picture.

    • public_about_mestring

      Text about the person shown publicly.

    • global_profileboolean

      The profile is a global profile across installations.

    • name_display_typestring

      How the name is shown, for example full name or first name only.

    • show_profile_pictureboolean

      The profile picture is shown.

    • profile_picture_check_statusstring

      Pruefstatus des Profilbilds (KI-Pruefung, siehe MediaSocialProfilePictureHelper): null = nie geprueft (Pruefung aus), pending, approved, rejected. Nur ein freigegebenes Bild landet in profilePictureUrl, solange die Pruefung eingeschaltet ist.

    • createdstring (date-time)

      Point in time the entity was created.

    • updatedstring (date-time)

      Point in time the entity was last updated.

    • deletedboolean

      This property is used to mark an entity as deleted / archived

  • createdstring (date-time)

    Point in time the entity was created.

  • updatedstring (date-time)

    Point in time the entity was last updated.

  • deletedboolean

    This property is used to mark an entity as deleted / archived

Request
curl --request POST \
  --url https://your-instance.iw-erp.de/api/media/social_report/user \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "comment": {
      "text": "Text",
      "url": "https://vynst.de",
      "deleted": true
    },
    "reason": "string",
    "social_post": {
      "text": "Text",
      "url": "https://vynst.de",
      "url_title": "Beispiel",
      "headline": "string",
      "url_source_image": "string",
      "deleted": true
    },
    "deleted": true
  }
}
'
Response 200 application/json
{
  "id": 42,
  "comment": {
    "id": 42,
    "text": "Text",
    "url": "https://vynst.de",
    "moderation_status": "string",
    "moderated_manually": true,
    "report_count": 1,
    "social_profile": {
      "id": 42,
      "public_name": "Beispiel",
      "profile_picture_url": "https://vynst.de",
      "public_about_me": "string",
      "global_profile": true,
      "name_display_type": "string",
      "show_profile_picture": true,
      "profile_picture_check_status": "string",
      "created": "2026-10-15T09:30:00+02:00",
      "updated": "2026-10-15T09:30:00+02:00"
    },
    "created": "2026-10-15T09:30:00+02:00",
    "updated": "2026-10-15T09:30:00+02:00",
    "deleted": true
  },
  "reason": "string",
  "social_post": {
    "id": 42,
    "text": "Text",
    "url": "https://vynst.de",
    "url_title": "Beispiel",
    "url_image": "string",
    "headline": "string",
    "url_source_image": "string",
    "image_token": "string",
    "moderation_status": "string",
    "moderated_manually": true
  },
  "social_profile": {
    "id": 42,
    "public_name": "Beispiel",
    "profile_picture_url": "https://vynst.de",
    "public_about_me": "string",
    "global_profile": true,
    "name_display_type": "string",
    "show_profile_picture": true,
    "profile_picture_check_status": "string",
    "created": "2026-10-15T09:30:00+02:00",
    "updated": "2026-10-15T09:30:00+02:00"
  },
  "created": "2026-10-15T09:30:00+02:00",
  "updated": "2026-10-15T09:30:00+02:00",
  "deleted": true
}

Returns a single content report (admin only)

GET/api/media/social_report/{identifier}

Path parameters

identifierrequiredstring

Responses

200Returns a single MediaSocialReport objectMediaSocialReport

Show fields (8)
  • idinteger

    Primary key of the social report. Internal ID.

  • reasonstring

    Free-text reason given by the reporter. Optional.

  • social_postMediaSocialPost10

    Reported post.

    Show fields (15)
    • url_imagestring

      Proxy URL that resolves to this post's image. Returns null until a preview has been extracted and an imageToken is assigned.

    • idinteger

      Primary key of the social post. Internal ID.

    • headlinestring

      Headline of the post.

    • textstring

      Text of the post.

    • urlstring

      Link in the post.

    • url_titlestring

      Title of the link in the post.

    • url_source_imagestring

      Raw origin URL of the preview image. Stored as scope-only; never exposed directly to non-admin callers — use the virtual url_image property instead.

    • image_tokenstring

      Server-assigned, never accepted from API input — omitted from oaInput groups on purpose.

    • moderation_statusstring

      Moderation status, for example pending or approved.

    • moderated_manuallyboolean

      True once a moderator decided about this entry by hand. Automatic decisions - a trigger match on creation, the batch auto-approve - leave it false, and that is what lets member reports push an entry back into moderation later on.

    • report_countinteger

      Number of distinct members who reported this entry. Moderators only.

    • social_profileMediaSocialProfile10

      Profile that wrote the post.

    • createdstring (date-time)

      Point in time the entity was created.

    • updatedstring (date-time)

      Point in time the entity was last updated.

    • deletedboolean

      This property is used to mark an entity as deleted / archived

  • commentMediaSocialPostComment4

    Reported comment.

    Show fields (10)
    • idinteger

      Primary key of the social post comment. Internal ID.

    • textstring

      Text of the comment.

    • urlstring

      Link in the comment.

    • moderation_statusstring

      Moderation status, for example pending or approved.

    • moderated_manuallyboolean

      True once a moderator decided about this entry by hand. Automatic decisions - a trigger match on creation, the batch auto-approve - leave it false, and that is what lets member reports push an entry back into moderation later on.

    • report_countinteger

      Number of distinct members who reported this entry. Moderators only.

    • social_profileMediaSocialProfile10

      Profile that wrote the comment.

    • createdstring (date-time)

      Point in time the entity was created.

    • updatedstring (date-time)

      Point in time the entity was last updated.

    • deletedboolean

      This property is used to mark an entity as deleted / archived

  • social_profileMediaSocialProfile10

    The reporting member.

    Show fields (11)
    • idinteger

      Primary key of the social profile. Internal ID.

    • public_namestring

      Name shown publicly.

    • profile_picture_urlstring

      URL of the profile picture.

    • public_about_mestring

      Text about the person shown publicly.

    • global_profileboolean

      The profile is a global profile across installations.

    • name_display_typestring

      How the name is shown, for example full name or first name only.

    • show_profile_pictureboolean

      The profile picture is shown.

    • profile_picture_check_statusstring

      Pruefstatus des Profilbilds (KI-Pruefung, siehe MediaSocialProfilePictureHelper): null = nie geprueft (Pruefung aus), pending, approved, rejected. Nur ein freigegebenes Bild landet in profilePictureUrl, solange die Pruefung eingeschaltet ist.

    • createdstring (date-time)

      Point in time the entity was created.

    • updatedstring (date-time)

      Point in time the entity was last updated.

    • deletedboolean

      This property is used to mark an entity as deleted / archived

  • createdstring (date-time)

    Point in time the entity was created.

  • updatedstring (date-time)

    Point in time the entity was last updated.

  • deletedboolean

    This property is used to mark an entity as deleted / archived

Request
curl --request GET \
  --url https://your-instance.iw-erp.de/api/media/social_report/42 \
  --header 'x-iw-jwt-token: <TOKEN>'
Response 200 application/json
{
  "id": 42,
  "comment": {
    "id": 42,
    "text": "Text",
    "url": "https://vynst.de",
    "moderation_status": "string",
    "moderated_manually": true,
    "report_count": 1,
    "social_profile": {
      "id": 42,
      "public_name": "Beispiel",
      "profile_picture_url": "https://vynst.de",
      "public_about_me": "string",
      "global_profile": true,
      "name_display_type": "string",
      "show_profile_picture": true,
      "profile_picture_check_status": "string",
      "created": "2026-10-15T09:30:00+02:00",
      "updated": "2026-10-15T09:30:00+02:00"
    },
    "created": "2026-10-15T09:30:00+02:00",
    "updated": "2026-10-15T09:30:00+02:00",
    "deleted": true
  },
  "reason": "string",
  "social_post": {
    "id": 42,
    "text": "Text",
    "url": "https://vynst.de",
    "url_title": "Beispiel",
    "url_image": "string",
    "headline": "string",
    "url_source_image": "string",
    "image_token": "string",
    "moderation_status": "string",
    "moderated_manually": true
  },
  "social_profile": {
    "id": 42,
    "public_name": "Beispiel",
    "profile_picture_url": "https://vynst.de",
    "public_about_me": "string",
    "global_profile": true,
    "name_display_type": "string",
    "show_profile_picture": true,
    "profile_picture_check_status": "string",
    "created": "2026-10-15T09:30:00+02:00",
    "updated": "2026-10-15T09:30:00+02:00"
  },
  "created": "2026-10-15T09:30:00+02:00",
  "updated": "2026-10-15T09:30:00+02:00",
  "deleted": true
}

Admin soft-deletes a report

DELETE/api/media/social_report/{identifier}

Path parameters

identifierrequiredstring

Responses

200Delete a content reportMediaSocialReport

Show fields (8)
  • idinteger

    Primary key of the social report. Internal ID.

  • reasonstring

    Free-text reason given by the reporter. Optional.

  • social_postMediaSocialPost10

    Reported post.

    Show fields (15)
    • url_imagestring

      Proxy URL that resolves to this post's image. Returns null until a preview has been extracted and an imageToken is assigned.

    • idinteger

      Primary key of the social post. Internal ID.

    • headlinestring

      Headline of the post.

    • textstring

      Text of the post.

    • urlstring

      Link in the post.

    • url_titlestring

      Title of the link in the post.

    • url_source_imagestring

      Raw origin URL of the preview image. Stored as scope-only; never exposed directly to non-admin callers — use the virtual url_image property instead.

    • image_tokenstring

      Server-assigned, never accepted from API input — omitted from oaInput groups on purpose.

    • moderation_statusstring

      Moderation status, for example pending or approved.

    • moderated_manuallyboolean

      True once a moderator decided about this entry by hand. Automatic decisions - a trigger match on creation, the batch auto-approve - leave it false, and that is what lets member reports push an entry back into moderation later on.

    • report_countinteger

      Number of distinct members who reported this entry. Moderators only.

    • social_profileMediaSocialProfile10

      Profile that wrote the post.

    • createdstring (date-time)

      Point in time the entity was created.

    • updatedstring (date-time)

      Point in time the entity was last updated.

    • deletedboolean

      This property is used to mark an entity as deleted / archived

  • commentMediaSocialPostComment4

    Reported comment.

    Show fields (10)
    • idinteger

      Primary key of the social post comment. Internal ID.

    • textstring

      Text of the comment.

    • urlstring

      Link in the comment.

    • moderation_statusstring

      Moderation status, for example pending or approved.

    • moderated_manuallyboolean

      True once a moderator decided about this entry by hand. Automatic decisions - a trigger match on creation, the batch auto-approve - leave it false, and that is what lets member reports push an entry back into moderation later on.

    • report_countinteger

      Number of distinct members who reported this entry. Moderators only.

    • social_profileMediaSocialProfile10

      Profile that wrote the comment.

    • createdstring (date-time)

      Point in time the entity was created.

    • updatedstring (date-time)

      Point in time the entity was last updated.

    • deletedboolean

      This property is used to mark an entity as deleted / archived

  • social_profileMediaSocialProfile10

    The reporting member.

    Show fields (11)
    • idinteger

      Primary key of the social profile. Internal ID.

    • public_namestring

      Name shown publicly.

    • profile_picture_urlstring

      URL of the profile picture.

    • public_about_mestring

      Text about the person shown publicly.

    • global_profileboolean

      The profile is a global profile across installations.

    • name_display_typestring

      How the name is shown, for example full name or first name only.

    • show_profile_pictureboolean

      The profile picture is shown.

    • profile_picture_check_statusstring

      Pruefstatus des Profilbilds (KI-Pruefung, siehe MediaSocialProfilePictureHelper): null = nie geprueft (Pruefung aus), pending, approved, rejected. Nur ein freigegebenes Bild landet in profilePictureUrl, solange die Pruefung eingeschaltet ist.

    • createdstring (date-time)

      Point in time the entity was created.

    • updatedstring (date-time)

      Point in time the entity was last updated.

    • deletedboolean

      This property is used to mark an entity as deleted / archived

  • createdstring (date-time)

    Point in time the entity was created.

  • updatedstring (date-time)

    Point in time the entity was last updated.

  • deletedboolean

    This property is used to mark an entity as deleted / archived

Request
curl --request DELETE \
  --url https://your-instance.iw-erp.de/api/media/social_report/42 \
  --header 'x-iw-jwt-token: <TOKEN>'
Response 200 application/json
{
  "id": 42,
  "comment": {
    "id": 42,
    "text": "Text",
    "url": "https://vynst.de",
    "moderation_status": "string",
    "moderated_manually": true,
    "report_count": 1,
    "social_profile": {
      "id": 42,
      "public_name": "Beispiel",
      "profile_picture_url": "https://vynst.de",
      "public_about_me": "string",
      "global_profile": true,
      "name_display_type": "string",
      "show_profile_picture": true,
      "profile_picture_check_status": "string",
      "created": "2026-10-15T09:30:00+02:00",
      "updated": "2026-10-15T09:30:00+02:00"
    },
    "created": "2026-10-15T09:30:00+02:00",
    "updated": "2026-10-15T09:30:00+02:00",
    "deleted": true
  },
  "reason": "string",
  "social_post": {
    "id": 42,
    "text": "Text",
    "url": "https://vynst.de",
    "url_title": "Beispiel",
    "url_image": "string",
    "headline": "string",
    "url_source_image": "string",
    "image_token": "string",
    "moderation_status": "string",
    "moderated_manually": true
  },
  "social_profile": {
    "id": 42,
    "public_name": "Beispiel",
    "profile_picture_url": "https://vynst.de",
    "public_about_me": "string",
    "global_profile": true,
    "name_display_type": "string",
    "show_profile_picture": true,
    "profile_picture_check_status": "string",
    "created": "2026-10-15T09:30:00+02:00",
    "updated": "2026-10-15T09:30:00+02:00"
  },
  "created": "2026-10-15T09:30:00+02:00",
  "updated": "2026-10-15T09:30:00+02:00",
  "deleted": true
}