Skip to content
Developer

Feedback Public

Media7 EndpointsMedia / Feedback Public

The public roadmap timeline.

GET/api/media/feedback_public/roadmap

Responses

default

Request
curl --request GET \
  --url https://your-instance.iw-erp.de/api/media/feedback_public/roadmap \
  --header 'x-iw-jwt-token: <TOKEN>'

Confirms a guest submission or vote from the double opt-in link.

GET/api/media/feedback_public/confirm/{confirmToken}

The token is cleared on use, so a forwarded mail cannot be replayed.

Path parameters

confirmTokenrequiredstring

Responses

default

Request
curl --request GET \
  --url https://your-instance.iw-erp.de/api/media/feedback_public/confirm/42 \
  --header 'x-iw-jwt-token: <TOKEN>'

A single public entry with its comments and status history.

GET/api/media/feedback_public/board/{publicKey}/entry/{identifier}

Path parameters

publicKeyrequiredstring
identifierrequiredstring

Query parameters

voterTokenstringCaller's own voter token

Responses

default

Request
curl --request GET \
  --url https://your-instance.iw-erp.de/api/media/feedback_public/board/42/entry/42 \
  --header 'x-iw-jwt-token: <TOKEN>'

Submits an entry without a session.

POST/api/media/feedback_public/board/{publicKey}/entry

The response carries the guest token exactly once — it is the only way the guest can come back to their own entry, and it is never serialized again afterwards.

Path parameters

publicKeyrequiredstring

Request body application/json

  • dataMediaFeedbackEntry2
    Show fields (17)
    • boardMediaFeedbackBoard2

      Feedback board the entry belongs to.

    • headlinestring

      Headline of the feedback entry.

    • textstring

      Text of the feedback entry.

    • feedback_typestring

      Type of the feedback, for example idea or problem.

    • statusstring

      Status of the feedback, for example open, planned or done.

    • status_notestring

      Publicly visible reason for the current status. A declined wish without a reason is worse than no board at all, so this is exposed to every access tier.

    • moderation_statusstring

      Moderation status, for example pending or approved.

    • moderation_reasonstring

      Reason for the moderation decision.

    • social_profileMediaSocialProfile16

      Author when submitted by a logged-in person. Reuses the social profile so the pseudonymity settings a person already chose apply here too.

    • guest_namestring

      Name of the guest who wrote the entry.

    • attachmentsarray<Attachment12>

      Files attached to the entry.

    • duplicate_ofMediaFeedbackEntry2

      Merge target. Set together with STATUS_DUPLICATE.

    • roadmap_itemsarray<MediaFeedbackRoadmapItem2>
    • internal_notestring

      Scope-only.

    • internal_priorityinteger

      Scope-only.

    • deletedboolean

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

    • ucatsarray<UnifiedCategory11>

      Unified categories of the entity.

Responses

default

Request
curl --request POST \
  --url https://your-instance.iw-erp.de/api/media/feedback_public/board/42/entry \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "text": "Text",
    "guest_name": "Beispiel",
    "board": {
      "name": "Beispiel",
      "public_title": "Beispiel",
      "public_description": "Text",
      "image_url": "https://vynst.de",
      "sort_order": 1,
      "allow_new_entries": true
    },
    "headline": "string",
    "feedback_type": "string",
    "status": "string"
  }
}
'

Casts a guest vote.

POST/api/media/feedback_public/board/{publicKey}/vote

Path parameters

publicKeyrequiredstring

Query parameters

entryIdentifierrequiredstringEntry to vote for
voterTokenrequiredstringCaller's own voter token

Responses

default

Request
curl --request POST \
  --url 'https://your-instance.iw-erp.de/api/media/feedback_public/board/42/vote?entryIdentifier=42&voterToken=string' \
  --header 'x-iw-jwt-token: <TOKEN>'

Withdraws a guest vote.

DELETE/api/media/feedback_public/board/{publicKey}/vote

Path parameters

publicKeyrequiredstring

Query parameters

entryIdentifierrequiredstringEntry to withdraw the vote from
voterTokenrequiredstringCaller's own voter token

Responses

default

Request
curl --request DELETE \
  --url 'https://your-instance.iw-erp.de/api/media/feedback_public/board/42/vote?entryIdentifier=42&voterToken=string' \
  --header 'x-iw-jwt-token: <TOKEN>'

Board, capabilities, limits and the first page of entries — everything the widget needs to draw itself, in one request. Split across several calls it would flicker while it works out what it is allowed to show.

GET/api/media/feedback_public/board/{publicKey}

Path parameters

publicKeyrequiredstring

Query parameters

sortstringtop, new or status
statusstringFilter by entry status
pageintegerZero-based page index
limitintegerPage size, max 100
voterTokenstringCaller's own voter token, to mark entries they already voted for

Responses

default

Request
curl --request GET \
  --url https://your-instance.iw-erp.de/api/media/feedback_public/board/42 \
  --header 'x-iw-jwt-token: <TOKEN>'