Skip to content
Area

Notifications

39 addresses. Not promised — they belong to the internals and can change with any release. If you need something to stay put, use the promised nineteen.

39 addresses

GET /api/feedback may change

All feedback

Every quality rating in the installation, for whoever runs it.

Fields and shape

Parameters

unansweredboolean query

Response

FieldType
idnumber required
media_typestring required
tmdb_idnumber required
seasonnumber or null required
ratingnumber required
commentstring or null required
titlestring required
replystring or null required
outdatedboolean required
updated_atstring required
user_namestring

Response shape

[
  {
    "id": "number",
    "media_type": "string",
    "tmdb_id": "number",
    "season": "number | null",
    "rating": "number",
    "comment": "string | null",
    "title": "string",
    "reply": "string | null",
    "outdated": "boolean",
    "updated_at": "string",
    "user_name": "string"
  }
]

GET /api/feedback/mine may change

Your own feedback

The quality ratings the calling account has given, with any replies.

Fields and shape

Response

FieldType
idnumber required
media_typestring required
tmdb_idnumber required
seasonnumber or null required
ratingnumber required
commentstring or null required
titlestring required
replystring or null required
outdatedboolean required
updated_atstring required
user_namestring

Response shape

[
  {
    "id": "number",
    "media_type": "string",
    "tmdb_id": "number",
    "season": "number | null",
    "rating": "number",
    "comment": "string | null",
    "title": "string",
    "reply": "string | null",
    "outdated": "boolean",
    "updated_at": "string",
    "user_name": "string"
  }
]

PUT /api/feedback/{media_type}/{tmdb_id} may change

Rate the quality of a title

How good the downloaded copy is. Anyone may, not just whoever requested it: this is about the file, and everybody watching it sees the same file.

Fields and shape

Parameters

media_typestring path required
tmdb_idnumber path required

Request body

FieldType
ratingnumber required
commentstring or null
titlestring
seasonnumber or null

Response

FieldType
idnumber required
media_typestring required
tmdb_idnumber required
seasonnumber or null required
ratingnumber required
commentstring or null required
titlestring required
replystring or null required
outdatedboolean required
updated_atstring required
user_namestring

Response shape

{
  "id": "number",
  "media_type": "string",
  "tmdb_id": "number",
  "season": "number | null",
  "rating": "number",
  "comment": "string | null",
  "title": "string",
  "reply": "string | null",
  "outdated": "boolean",
  "updated_at": "string",
  "user_name": "string"
}

POST /api/feedback/{rating_id}/reply may change

Reply to a rating

Administrators only. Approvers see the ratings but may not answer them: a reply is a conversation, and that belongs with whoever runs the installation.

Fields and shape

Parameters

rating_idnumber path required

Request body

FieldType
replystring required

Response

FieldType
idnumber required
media_typestring required
tmdb_idnumber required
seasonnumber or null required
ratingnumber required
commentstring or null required
titlestring required
replystring or null required
outdatedboolean required
updated_atstring required
user_namestring

Response shape

{
  "id": "number",
  "media_type": "string",
  "tmdb_id": "number",
  "season": "number | null",
  "rating": "number",
  "comment": "string | null",
  "title": "string",
  "reply": "string | null",
  "outdated": "boolean",
  "updated_at": "string",
  "user_name": "string"
}

DELETE /api/notifications may change

Delete all your notifications

Removes them rather than only marking them read.

GET /api/notifications may change

Your own notifications

Newest first, with their read state.

Fields and shape

Parameters

unread_onlyboolean query
limitnumber query

Response

FieldType
idnumber required
typedownload_complete | approved | rejected | cancelled | request_pending | feedback | feedback_poor | feedback_reply | ticket_new | ticket_reply | user_imported | mediaserver_reconnect | storage_released | storage_kept | storage_deleted | storage_release_requested | storage_grew | storage_scheduled | storage_unscheduled | request_deferred | child_wish | watch_ready | watch_episodes | instance_health | rating_outdated | request_fulfilled | invitation_redeemed | invitation_on_hold | download_stuck required
message_keystring required
message_titlestring or null required
seasonnumber or null
episodeslist of number or null
request_idnumber or null required
ticket_idnumber or null required
is_readboolean required
created_attimestamp (ISO 8601) required
zielstring required

Response shape

[
  {
    "id": "number",
    "type": "download_complete | approved | rejected | cancelled | request_pending | feedback | feedback_poor | feedback_reply | ticket_new | ticket_reply | user_imported | mediaserver_reconnect | storage_released | storage_kept | storage_deleted | storage_release_requested | storage_grew | storage_scheduled | storage_unscheduled | request_deferred | child_wish | watch_ready | watch_episodes | instance_health | rating_outdated | request_fulfilled | invitation_redeemed | invitation_on_hold | download_stuck",
    "message_key": "string",
    "message_title": "string | null",
    "season": "number | null",
    "episodes": [
      "number"
    ],
    "request_id": "number | null",
    "ticket_id": "number | null",
    "is_read": "boolean",
    "created_at": "ISO 8601",
    "ziel": "string"
  }
]

POST /api/notifications/read-all may change

Mark everything as read

The notifications stay, they are only no longer unread.

GET /api/notifications/unread/count may change

How many unread notifications

A plain number for the bell badge.

DELETE /api/notifications/{notification_id} may change

Delete one notification

Removes a single entry.

Fields and shape

Parameters

notification_idnumber path required

POST /api/notifications/{notification_id}/read may change

Mark one as read

Marks a single notification as read.

Fields and shape

Parameters

notification_idnumber path required

GET /api/push/devices may change

The subscribed devices

Every browser that subscribed for this account: a label such as "Chrome, Windows", when it subscribed, when it was last reached and the last final delivery failure. Pass your own endpoint to have this browser marked. Subscription addresses are never returned.

Fields and shape

Parameters

endpointstring query

Response

FieldType
idnumber required
namestring required
thisboolean required
created_attimestamp (ISO 8601) required
last_successtimestamp (ISO 8601) or null required
last_errorstring or null required
last_error_attimestamp (ISO 8601) or null required
vorbelegtboolean

Response shape

[
  {
    "id": "number",
    "name": "string",
    "this": "boolean",
    "created_at": "ISO 8601",
    "last_success": "ISO 8601 | null",
    "last_error": "string | null",
    "last_error_at": "ISO 8601 | null",
    "vorbelegt": "boolean"
  }
]

POST /api/push/devices may change

Subscribe this browser

Registers a PushSubscription for the signed-in user, flattened to endpoint, p256dh and auth. The same endpoint never creates a second row; registering it again updates the row and, on a shared computer, moves it to whoever is signed in now. When it is the first device and no push switch is set yet, all switches are turned on so the subscription does not run into a void; vorbelegt says whether that happened. Which events reach the device is decided by the push_* fields on the account, via PATCH /api/auth/me.

Fields and shape

Request body

FieldType
endpointstring required
p256dhstring required
authstring required
languagestring

Response

FieldType
idnumber required
namestring required
thisboolean required
created_attimestamp (ISO 8601) required
last_successtimestamp (ISO 8601) or null required
last_errorstring or null required
last_error_attimestamp (ISO 8601) or null required
vorbelegtboolean

Response shape

{
  "id": "number",
  "name": "string",
  "this": "boolean",
  "created_at": "ISO 8601",
  "last_success": "ISO 8601 | null",
  "last_error": "string | null",
  "last_error_at": "ISO 8601 | null",
  "vorbelegt": "boolean"
}

DELETE /api/push/devices/{ziel_id} may change

Unsubscribe a device

Removes one of your own devices; pending messages for it are dropped with it. Devices of other accounts are invisible here and answer 404.

Fields and shape

Parameters

ziel_idnumber path required

GET /api/push/key may change

The public key for web push

What the browser passes as applicationServerKey when it subscribes: the raw, uncompressed P-256 point in base64url. Generated once per installation on first use and never changed afterwards - a new key would silently orphan every subscribed device.

Fields and shape

Response

FieldType
public_keystring required

Response shape

{
  "public_key": "string"
}

POST /api/push/test may change

Send a test message

Delivers a test notification right away - to the device whose endpoint is given, or to every subscribed device. Between "the browser granted permission" and "something actually shows up" sit a service worker, a push service and a system setting that can each stay silent; this is how you find out which. A subscription the push service no longer knows (404 or 410) is removed on the spot.

Fields and shape

Request body

FieldType
endpointstring or null

Response

FieldType
okboolean required
messagestring required

Response shape

{
  "ok": "boolean",
  "message": "string"
}

GET /api/settings/channels/rueckkanaele may change

See where Nexview notifies its users

One row per personal target: a callback address that an application registered for itself - a Home Assistant, typically - or a browser that subscribed to web push. These are not set up here and cannot be created through this API; what they receive is whatever their owner also sees in their notification bell, and never what belongs to somebody else. The row shows who it belongs to, which key registered it and the last delivery failure, but not the messages themselves. For a browser only the push service is shown, never the full subscription address.

Fields and shape

Response

FieldType
idnumber required
personstring required
kanalstring required
namestring required
schluesselstring or null required
urlstring required
languagestring required
bestaetigtboolean required
angelegttimestamp (ISO 8601) required
letzter_fehlerstring or null required

Response shape

[
  {
    "id": "number",
    "person": "string",
    "kanal": "string",
    "name": "string",
    "schluessel": "string | null",
    "url": "string",
    "language": "string",
    "bestaetigt": "boolean",
    "angelegt": "ISO 8601",
    "letzter_fehler": "string | null"
  }
]

DELETE /api/settings/channels/rueckkanaele/{ziel_id} may change

Disconnect a callback

Nexview stops notifying that address. The key stays valid and the integration keeps asking on its own; to take an integration away entirely, revoke its key instead.

Fields and shape

Parameters

ziel_idnumber path required

POST /api/settings/channels/{channel}/chats may change

Who wrote to this bot

For a bot that does not exist in the database yet - during setup the token is in the form, not stored. Saves the detour of asking a third-party bot who has written to yours.

Fields and shape

Parameters

channelntfy | gotify | email | telegram | discord | webhook | apprise path required

Request body

FieldType
namestring or null
urlstring or null
topicstring or null
addressstring or null
subjectstring or null
chat_idstring or null
thread_idstring or null
silentstring or null
authstring or null
usernamestring or null
passwordstring or null
tokenstring or null
languagestring or null
eventsobject or null

POST /api/settings/channels/{channel}/check may change

Is the instance reachable

Without a code - nothing can arrive there yet. For the upper level of services that have two: a typo in the address should show up before anybody sets up topics underneath it.

Fields and shape

Parameters

channelntfy | gotify | email | telegram | discord | webhook | apprise path required
target_idnumber or null query

Request body

FieldType
namestring or null
urlstring or null
topicstring or null
addressstring or null
subjectstring or null
chat_idstring or null
thread_idstring or null
silentstring or null
authstring or null
usernamestring or null
passwordstring or null
tokenstring or null
languagestring or null
eventsobject or null

Response

FieldType
okboolean required
messagestring required
valuesobject or null

Response shape

{
  "ok": "boolean",
  "message": "string",
  "values": "object | null"
}

POST /api/settings/channels/{channel}/confirm may change

Confirm the code from the test message

Only after this can the target be saved. Proves that messages actually arrive where they are supposed to.

Fields and shape

Parameters

channelntfy | gotify | email | telegram | discord | webhook | apprise path required

Request body

FieldType
codestring required

Response

FieldType
okboolean required
messagestring required
valuesobject or null

Response shape

{
  "ok": "boolean",
  "message": "string",
  "values": "object | null"
}

GET /api/settings/channels/{channel}/targets may change

All targets of this channel

Every configured target of this service - one card each, topics included.

Fields and shape

Parameters

channelntfy | gotify | email | telegram | discord | webhook | apprise path required

POST /api/settings/channels/{channel}/targets may change

Create a target

Creates an instance - with Gotify, that is also the mailbox.

Fields and shape

Parameters

channelntfy | gotify | email | telegram | discord | webhook | apprise path required

Request body

FieldType
namestring or null
urlstring or null
topicstring or null
addressstring or null
subjectstring or null
chat_idstring or null
thread_idstring or null
silentstring or null
authstring or null
usernamestring or null
passwordstring or null
tokenstring or null
languagestring or null
eventsobject or null

POST /api/settings/channels/{channel}/targets/{parent_id}/children may change

Create a topic

Creates a topic inside an existing instance.

Fields and shape

Parameters

channelntfy | gotify | email | telegram | discord | webhook | apprise path required
parent_idnumber path required

Request body

FieldType
namestring or null
urlstring or null
topicstring or null
addressstring or null
subjectstring or null
chat_idstring or null
thread_idstring or null
silentstring or null
authstring or null
usernamestring or null
passwordstring or null
tokenstring or null
languagestring or null
eventsobject or null

DELETE /api/settings/channels/{channel}/targets/{target_id} may change

Remove a target

Removes the target and everything hanging off it. With an ntfy instance the topics go too - without an address and credentials they would have nothing to talk to.

Fields and shape

Parameters

channelntfy | gotify | email | telegram | discord | webhook | apprise path required
target_idnumber path required

PUT /api/settings/channels/{channel}/targets/{target_id} may change

Change a target

Address, credentials and name. Changing what messages arrive there is a separate endpoint.

Fields and shape

Parameters

channelntfy | gotify | email | telegram | discord | webhook | apprise path required
target_idnumber path required

Request body

FieldType
namestring or null
urlstring or null
topicstring or null
addressstring or null
subjectstring or null
chat_idstring or null
thread_idstring or null
silentstring or null
authstring or null
usernamestring or null
passwordstring or null
tokenstring or null
languagestring or null
eventsobject or null

POST /api/settings/channels/{channel}/targets/{target_id}/chats may change

Who wrote to this stored bot

The same question for a bot that is already saved: whoever sent it /start or added it to a group appears here, so the chat can be picked instead of typed.

Fields and shape

Parameters

channelntfy | gotify | email | telegram | discord | webhook | apprise path required
target_idnumber path required

PUT /api/settings/channels/{channel}/targets/{target_id}/enabled may change

Switch a target on or off

Deliberately its own endpoint rather than part of saving: the switch sits on the card and should take effect where it is, without opening a form.

Fields and shape

Parameters

channelntfy | gotify | email | telegram | discord | webhook | apprise path required
target_idnumber path required

Request body

FieldType
enabledboolean required

PUT /api/settings/channels/{channel}/targets/{target_id}/events may change

What this mailbox is told about

Only on a confirmed target. Ticks on an unverified one would quietly fill the outbox with messages nobody receives.

Fields and shape

Parameters

channelntfy | gotify | email | telegram | discord | webhook | apprise path required
target_idnumber path required

Request body

FieldType
eventsobject required

POST /api/settings/channels/{channel}/test may change

Send a test message with a code

Tests the typed-in values, not the stored ones - test first, save afterwards. The code has to be confirmed before the target counts as working.

Fields and shape

Parameters

channelntfy | gotify | email | telegram | discord | webhook | apprise path required
target_idnumber or null query
parent_idnumber or null query

Request body

FieldType
namestring or null
urlstring or null
topicstring or null
addressstring or null
subjectstring or null
chat_idstring or null
thread_idstring or null
silentstring or null
authstring or null
usernamestring or null
passwordstring or null
tokenstring or null
languagestring or null
eventsobject or null

Response

FieldType
okboolean required
messagestring required
valuesobject or null

Response shape

{
  "ok": "boolean",
  "message": "string",
  "values": "object | null"
}

GET /api/tickets may change

Your tickets

Your own; for an administrator, everyone's.

Fields and shape

Parameters

statusopen | in_progress | closed or null query
user_idnumber or null query

Response

FieldType
idnumber required
subjectstring required
statusopen | in_progress | closed required
created_attimestamp (ISO 8601) required
updated_attimestamp (ISO 8601) required
closed_attimestamp (ISO 8601) or null required
last_reply_attimestamp (ISO 8601) or null required
last_reply_bynumber or null required
media_typemovie | tv or null required
tmdb_idnumber or null required
media_titlestring or null required
user_idnumber required
usernamestring required
display_namestring or null required
avatar_urlstring or null required
message_countnumber required
opened_bynumber or null required
opened_by_namestring or null required

Response shape

[
  {
    "id": "number",
    "subject": "string",
    "status": "open | in_progress | closed",
    "created_at": "ISO 8601",
    "updated_at": "ISO 8601",
    "closed_at": "ISO 8601 | null",
    "last_reply_at": "ISO 8601 | null",
    "last_reply_by": "number | null",
    "media_type": "movie | tv | null",
    "tmdb_id": "number | null",
    "media_title": "string | null",
    "user_id": "number",
    "username": "string",
    "display_name": "string | null"
  }
]

POST /api/tickets may change

Open a ticket

Creates a ticket with a first message. Goes to the administrators.

Fields and shape

Request body

FieldType
subjectstring required
bodystring required
user_idnumber or null
media_typemovie | tv or null
tmdb_idnumber or null
media_titlestring or null

Response

FieldType
idnumber required
subjectstring required
statusopen | in_progress | closed required
created_attimestamp (ISO 8601) required
updated_attimestamp (ISO 8601) required
closed_attimestamp (ISO 8601) or null required
last_reply_attimestamp (ISO 8601) or null required
last_reply_bynumber or null required
media_typemovie | tv or null required
tmdb_idnumber or null required
media_titlestring or null required
user_idnumber required
usernamestring required
display_namestring or null required
avatar_urlstring or null required
message_countnumber required
opened_bynumber or null required
opened_by_namestring or null required
messageslist of MessageOut required
kinderkonten_offenboolean

Response shape

{
  "id": "number",
  "subject": "string",
  "status": "open | in_progress | closed",
  "created_at": "ISO 8601",
  "updated_at": "ISO 8601",
  "closed_at": "ISO 8601 | null",
  "last_reply_at": "ISO 8601 | null",
  "last_reply_by": "number | null",
  "media_type": "movie | tv | null",
  "tmdb_id": "number | null",
  "media_title": "string | null",
  "user_id": "number",
  "username": "string",
  "display_name": "string | null"
}

POST /api/tickets/delete may change

Delete closed tickets for good

Administrators only. Deliberately POST /delete and not DELETE: a body does not belong on a DELETE, and this needs the list of what to remove.

Fields and shape

Request body

FieldType
ticket_idslist of number required

POST /api/tickets/kontoaufloesung may change

Apply to have your account deleted

For users and approvers. Arrives as an ordinary ticket with the administrators, who see the consequences before they decide. The body has to carry {"bestaetigt": true}; without it nothing is filed (422).

Fields and shape

Request body

FieldType
bestaetigtboolean

Response

FieldType
idnumber required
subjectstring required
statusopen | in_progress | closed required
created_attimestamp (ISO 8601) required
updated_attimestamp (ISO 8601) required
closed_attimestamp (ISO 8601) or null required
last_reply_attimestamp (ISO 8601) or null required
last_reply_bynumber or null required
media_typemovie | tv or null required
tmdb_idnumber or null required
media_titlestring or null required
user_idnumber required
usernamestring required
display_namestring or null required
avatar_urlstring or null required
message_countnumber required
opened_bynumber or null required
opened_by_namestring or null required
messageslist of MessageOut required
kinderkonten_offenboolean

Response shape

{
  "id": "number",
  "subject": "string",
  "status": "open | in_progress | closed",
  "created_at": "ISO 8601",
  "updated_at": "ISO 8601",
  "closed_at": "ISO 8601 | null",
  "last_reply_at": "ISO 8601 | null",
  "last_reply_by": "number | null",
  "media_type": "movie | tv | null",
  "tmdb_id": "number | null",
  "media_title": "string | null",
  "user_id": "number",
  "username": "string",
  "display_name": "string | null"
}

PATCH /api/tickets/messages/{message_id} may change

Edit a message

Corrects the text of one's own message in a ticket.

Fields and shape

Parameters

message_idnumber path required

Request body

FieldType
bodystring required

Response

FieldType
idnumber required
subjectstring required
statusopen | in_progress | closed required
created_attimestamp (ISO 8601) required
updated_attimestamp (ISO 8601) required
closed_attimestamp (ISO 8601) or null required
last_reply_attimestamp (ISO 8601) or null required
last_reply_bynumber or null required
media_typemovie | tv or null required
tmdb_idnumber or null required
media_titlestring or null required
user_idnumber required
usernamestring required
display_namestring or null required
avatar_urlstring or null required
message_countnumber required
opened_bynumber or null required
opened_by_namestring or null required
messageslist of MessageOut required
kinderkonten_offenboolean

Response shape

{
  "id": "number",
  "subject": "string",
  "status": "open | in_progress | closed",
  "created_at": "ISO 8601",
  "updated_at": "ISO 8601",
  "closed_at": "ISO 8601 | null",
  "last_reply_at": "ISO 8601 | null",
  "last_reply_by": "number | null",
  "media_type": "movie | tv | null",
  "tmdb_id": "number | null",
  "media_title": "string | null",
  "user_id": "number",
  "username": "string",
  "display_name": "string | null"
}

GET /api/tickets/open-count may change

How many tickets need attention

For the menu badge. For an administrator, everybody's open tickets; for everyone else, their own ones that have been answered.

GET /api/tickets/{ticket_id} may change

One ticket

The ticket with all its messages.

Fields and shape

Parameters

ticket_idnumber path required

Response

FieldType
idnumber required
subjectstring required
statusopen | in_progress | closed required
created_attimestamp (ISO 8601) required
updated_attimestamp (ISO 8601) required
closed_attimestamp (ISO 8601) or null required
last_reply_attimestamp (ISO 8601) or null required
last_reply_bynumber or null required
media_typemovie | tv or null required
tmdb_idnumber or null required
media_titlestring or null required
user_idnumber required
usernamestring required
display_namestring or null required
avatar_urlstring or null required
message_countnumber required
opened_bynumber or null required
opened_by_namestring or null required
messageslist of MessageOut required
kinderkonten_offenboolean

Response shape

{
  "id": "number",
  "subject": "string",
  "status": "open | in_progress | closed",
  "created_at": "ISO 8601",
  "updated_at": "ISO 8601",
  "closed_at": "ISO 8601 | null",
  "last_reply_at": "ISO 8601 | null",
  "last_reply_by": "number | null",
  "media_type": "movie | tv | null",
  "tmdb_id": "number | null",
  "media_title": "string | null",
  "user_id": "number",
  "username": "string",
  "display_name": "string | null"
}

PATCH /api/tickets/{ticket_id} may change

Set a ticket's state

Administrators only.

Fields and shape

Parameters

ticket_idnumber path required

Request body

FieldType
statusopen | in_progress | closed required

Response

FieldType
idnumber required
subjectstring required
statusopen | in_progress | closed required
created_attimestamp (ISO 8601) required
updated_attimestamp (ISO 8601) required
closed_attimestamp (ISO 8601) or null required
last_reply_attimestamp (ISO 8601) or null required
last_reply_bynumber or null required
media_typemovie | tv or null required
tmdb_idnumber or null required
media_titlestring or null required
user_idnumber required
usernamestring required
display_namestring or null required
avatar_urlstring or null required
message_countnumber required
opened_bynumber or null required
opened_by_namestring or null required
messageslist of MessageOut required
kinderkonten_offenboolean

Response shape

{
  "id": "number",
  "subject": "string",
  "status": "open | in_progress | closed",
  "created_at": "ISO 8601",
  "updated_at": "ISO 8601",
  "closed_at": "ISO 8601 | null",
  "last_reply_at": "ISO 8601 | null",
  "last_reply_by": "number | null",
  "media_type": "movie | tv | null",
  "tmdb_id": "number | null",
  "media_title": "string | null",
  "user_id": "number",
  "username": "string",
  "display_name": "string | null"
}

POST /api/tickets/{ticket_id}/kinderkonten-freischalten may change

Grant child profiles from a ticket

Settles the application in one click - grants the permission, replies, closes the ticket.

Fields and shape

Parameters

ticket_idnumber path required

Response

FieldType
idnumber required
subjectstring required
statusopen | in_progress | closed required
created_attimestamp (ISO 8601) required
updated_attimestamp (ISO 8601) required
closed_attimestamp (ISO 8601) or null required
last_reply_attimestamp (ISO 8601) or null required
last_reply_bynumber or null required
media_typemovie | tv or null required
tmdb_idnumber or null required
media_titlestring or null required
user_idnumber required
usernamestring required
display_namestring or null required
avatar_urlstring or null required
message_countnumber required
opened_bynumber or null required
opened_by_namestring or null required
messageslist of MessageOut required
kinderkonten_offenboolean

Response shape

{
  "id": "number",
  "subject": "string",
  "status": "open | in_progress | closed",
  "created_at": "ISO 8601",
  "updated_at": "ISO 8601",
  "closed_at": "ISO 8601 | null",
  "last_reply_at": "ISO 8601 | null",
  "last_reply_by": "number | null",
  "media_type": "movie | tv | null",
  "tmdb_id": "number | null",
  "media_title": "string | null",
  "user_id": "number",
  "username": "string",
  "display_name": "string | null"
}

POST /api/tickets/{ticket_id}/messages may change

Reply in a ticket

Adds a message to the conversation.

Fields and shape

Parameters

ticket_idnumber path required

Request body

FieldType
bodystring required

Response

FieldType
idnumber required
subjectstring required
statusopen | in_progress | closed required
created_attimestamp (ISO 8601) required
updated_attimestamp (ISO 8601) required
closed_attimestamp (ISO 8601) or null required
last_reply_attimestamp (ISO 8601) or null required
last_reply_bynumber or null required
media_typemovie | tv or null required
tmdb_idnumber or null required
media_titlestring or null required
user_idnumber required
usernamestring required
display_namestring or null required
avatar_urlstring or null required
message_countnumber required
opened_bynumber or null required
opened_by_namestring or null required
messageslist of MessageOut required
kinderkonten_offenboolean

Response shape

{
  "id": "number",
  "subject": "string",
  "status": "open | in_progress | closed",
  "created_at": "ISO 8601",
  "updated_at": "ISO 8601",
  "closed_at": "ISO 8601 | null",
  "last_reply_at": "ISO 8601 | null",
  "last_reply_by": "number | null",
  "media_type": "movie | tv | null",
  "tmdb_id": "number | null",
  "media_title": "string | null",
  "user_id": "number",
  "username": "string",
  "display_name": "string | null"
}