GIgitea
notification

Mark notification threads as read, pinned or unread

put/notifications

Request

  • Base URL
    https://demo.gitea.com/api/v1
  • Auth
    • HTTP basic
    • or API key in query parameter token
    • or API key in query parameter access_token
    • or API key in header Authorization
    • or API key in query parameter sudo
    • or API key in header Sudo
    • or API key in header X-GITEA-OTP
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Query parameters

last_read_atstring date-time

Describes the last point that notifications were checked. Anything updated since this time will not be updated.

allstring

If true, mark all notifications on this repo. Default value is false

status-typesstring[]

Mark notifications with the provided status types. Options are: unread, read and/or pinned. Defaults to unread.

to-statusstring

Status to mark notifications as, Defaults to read.

Response

NotificationThreadList

idinteger

ID is the unique identifier for the notification thread

pinnedboolean

Pinned indicates if the notification is pinned

unreadboolean

Unread indicates if the notification has been read

updated_atstring date-time

UpdatedAt is the time when the notification was last updated

urlstring

URL is the API URL for this notification thread

Example response

[
  {
    "repository": {
      "repo_transfer": {
        "teams": [
          {
            "units": [
              "repo.code",
              "repo.issues",
              "repo.ext_issues",
              "repo.wiki",
              "repo.pulls",
              "repo.releases",
              "repo.projects",
              "repo.ext_wiki"
            ],
            "units_map": {
              "repo.code": "read",
              "repo.ext_issues": "none",
              "repo.ext_wiki": "none",
              "repo.issues": "write",
              "repo.projects": "none",
              "repo.pulls": "owner",
              "repo.releases": "none",
              "repo.wiki": "admin"
            }
          }
        ]
      }
    }
  }
]

Changes

No recorded changes to this operation across all 12 revisions of this API.