Skip to content
Modrinth Documentation

Get user's notifications

GET
/user/{id|username}/notifications

Authorizations

Parameters

Path Parameters

id|username
required
string
[
  "EEFFGGHH",
  "my_user"
]

The ID or username of the user

Responses

200

Expected response to a valid request

Array<object>
object
id
required

The id of the notification

string
UUVVWWXX
user_id
required

The id of the user who received the notification

string
EEFFGGHH
type

The type of notification

string
nullable
Allowed values: project_update team_invite status_change moderator_message 
project_update
title
required

The title of the notification

string
**My Project** has been updated!
text
required

The body text of the notification

string
The project, My Project, has released a new version: 1.0.0
link
required

A link to the related project or version

string
mod/AABBCCDD/version/IIJJKKLL
read
required

Whether the notification has been read or not

boolean
created
required

The time at which the notification was created

string format: ISO-8601
actions
required

A list of actions that can be performed

Array<object>

An action that can be performed on a notification

object
title

The friendly name for this action

string
Accept
action_route

The HTTP code and path to request in order to perform this action.

Array<string>
[
  "POST",
  "team/{id}/join"
]

401

Incorrect token scopes or no authorization to access the requested item(s)

object
error
required

The name of the error

string
unauthorized
description
required

The contents of the error

string
Authentication Error: Invalid Authentication Credentials

404

The requested item(s) were not found or no authorization to access the requested item(s)