GiteaHat
  1. notification
GiteaHat
  • Gitea接口
    • activitypub
      • Returns the Person actor for a user
      • Send to the inbox
    • admin
      • List cron tasks
      • Run cron task
      • List all organizations
      • List unadopted repositories
      • Adopt unadopted files as a repository
      • Delete unadopted files
      • Search users according filter conditions
      • Create a user
      • Delete a user
      • Edit an existing user
      • Add a public key on behalf of a user
      • Delete a user's public key
      • Create an organization
      • Create a repository on behalf of a user
    • miscellaneous
      • Render a markdown document as HTML
      • Render raw markdown as HTML
      • Returns the nodeinfo of the Gitea application
      • Get default signing-key.gpg
      • Returns the version of the Gitea application
    • notification
      • List users's notification threads
        GET
      • Mark notification threads as read, pinned or unread
        PUT
      • Check if unread notifications exist
        GET
      • Get notification thread by ID
        GET
      • Mark notification thread as read by ID
        PATCH
      • List users's notification threads on a specific repo
        GET
      • Mark notification threads as read, pinned or unread on a specific repo
        PUT
    • organization
      • Create a repository in an organization
      • Get list of organizations
      • Create an organization
      • Get an organization
      • Delete an organization
      • Edit an organization
      • List an organization's webhooks
      • Create a hook
      • Get a hook
      • Delete a hook
      • Update a hook
      • List an organization's labels
      • Create a label for an organization
      • Get a single label
      • Delete a label
      • Update a label
      • List an organization's members
      • Check if a user is a member of an organization
      • Remove a member from an organization
      • List an organization's public members
      • Check if a user is a public member of an organization
      • Publicize a user's membership
      • Conceal a user's membership
      • List an organization's repos
      • Create a repository in an organization
      • List an organization's teams
      • Create a team
      • Search for teams within an organization
      • Get a team
      • Delete a team
      • Edit a team
      • List a team's members
      • List a particular member of team
      • Add a team member
      • Remove a team member
      • List a team's repos
      • List a particular repo of team
      • Add a repository to a team
      • Remove a repository from a team
      • List the current user's organizations
      • List a user's organizations
      • Get user permissions in organization
    • package
      • Gets all packages of an owner
      • Gets a package
      • Delete a package
      • Gets all files of a package
    • issue
      • Search for issues across the repositories that the user has access to
      • List a repository's issues
      • Create an issue. If using deadline only the date will be taken into account, and time of day ignored.
      • List all comments in a repository
      • Get a comment
      • Delete a comment
      • Edit a comment
      • Get a list of reactions from a comment of an issue
      • Add a reaction to a comment of an issue
      • Remove a reaction from a comment of an issue
      • Get an issue
      • Delete an issue
      • Edit an issue. If using deadline only the date will be taken into account, and time of day ignored.
      • List all comments on an issue
      • Add a comment to an issue
      • Delete a comment
      • Edit a comment
      • Set an issue deadline. If set to null, the deadline is deleted. If using deadline only the date will be taken into account, and time of day ignored.
      • Get an issue's labels
      • Replace an issue's labels
      • Add a label to an issue
      • Remove all labels from an issue
      • Remove a label from an issue
      • Get a list reactions of an issue
      • Add a reaction to an issue
      • Remove a reaction from an issue
      • Delete an issue's existing stopwatch.
      • Start stopwatch on an issue.
      • Stop an issue's existing stopwatch.
      • Get users who subscribed on an issue.
      • Check if user is subscribed to an issue
      • Subscribe user to issue
      • Unsubscribe user from issue
      • List all comments and events on an issue
      • List an issue's tracked times
      • Add tracked time to a issue
      • Reset a tracked time of an issue
      • Delete specific tracked time
      • Get all of a repository's labels
      • Create a label
      • Get a single label
      • Delete a label
      • Update a label
      • Get all of a repository's opened milestones
      • Create a milestone
      • Get a milestone
      • Delete a milestone
      • Update a milestone
    • repository
      • Migrate a remote git repository
      • Search for repositories
      • Get a repository
      • Delete a repository
      • Edit a repository's properties. Only fields that are set will be changed.
      • Get an archive of a repository
      • Return all users that have write access and can be assigned to issues
      • List branch protections for a repository
      • Create a branch protections for a repository
      • Get a specific branch protection for the repository
      • Delete a specific branch protection for the repository
      • Edit a branch protections for a repository. Only fields that are set will be changed
      • List a repository's branches
      • Create a branch
      • Retrieve a specific branch from a repository, including its effective branch protection
      • Delete a specific branch from a repository
      • List a repository's collaborators
      • Check if a user is a collaborator of a repository
      • Add a collaborator to a repository
      • Delete a collaborator from a repository
      • Get repository permissions for a user
      • Get a list of all commits from a repository
      • Get a commit's combined status, by branch/tag/commit reference
      • Get a commit's statuses, by branch/tag/commit reference
      • Gets the metadata of all the entries of the root dir
      • Gets the metadata and contents (if a file) of an entry in a repository, or a list of entries if a dir
      • Update a file in a repository
      • Create a file in a repository
      • Delete a file in a repository
      • Apply diff patch to repository
      • Get the EditorConfig definitions of a file in a repository
      • List a repository's forks
      • Fork a repository
      • Gets the blob of a repository.
      • Get a single commit from a repository
      • Get a commit's diff or patch
      • Get a note corresponding to a single commit from a repository
      • Get specified ref or filtered repository's refs
      • Get specified ref or filtered repository's refs
      • Gets the tag object of an annotated tag (not lightweight tags)
      • Gets the tree of a repository.
      • List the hooks in a repository
      • Create a hook
      • List the Git hooks in a repository
      • Get a Git hook
      • Delete a Git hook in a repository
      • Edit a Git hook in a repository
      • Get a hook
      • Delete a hook in a repository
      • Edit a hook in a repository
      • Test a push webhook
      • Get available issue templates for a repository
      • List a repository's keys
      • Add a key to a repository
      • Get a repository's key by id
      • Delete a key from a repository
      • Get languages and number of bytes of code written
      • Get a file or it's LFS object from a repository
      • Sync a mirrored repository
      • List a repo's pull requests
      • Create a pull request
      • Get a pull request
      • Update a pull request. If using deadline only the date will be taken into account, and time of day ignored.
      • Get a pull request diff or patch
      • Get commits for a pull request
      • Check if a pull request has been merged
      • Merge a pull request
      • Cancel the scheduled auto merge for the given pull request
      • create review requests for a pull request
      • cancel review requests for a pull request
      • List all reviews for a pull request
      • Create a review to an pull request
      • Get a specific review for a pull request
      • Submit a pending review to an pull request
      • Delete a specific review from a pull request
      • Get a specific review for a pull request
      • Dismiss a review for a pull request
      • Cancel to dismiss a review for a pull request
      • Merge PR's baseBranch into headBranch
      • Get all push mirrors of the repository
      • add a push mirror to the repository
      • Sync all push mirrored repository
      • Get push mirror of the repository by remoteName
      • deletes a push mirror from a repository by remoteName
      • Get a file from a repository
      • List a repo's releases
      • Create a release
      • Get changed files for a pull request
      • Get a release by tag name
      • Delete a release by tag name
      • Get a release
      • Delete a release
      • Update a release
      • List release's attachments
      • Create a release attachment
      • Get a release attachment
      • Delete a release attachment
      • Edit a release attachment
      • Return all users that can be requested to review in this repo
      • Get signing-key.gpg for given repository
      • List a repo's stargazers
      • Get a commit's statuses
      • Create a commit status
      • List a repo's watchers
      • Check if the current user is watching a repo
      • Watch a repo
      • Unwatch a repo
      • List a repository's tags
      • Create a new git tag in a repository
      • Get the tag of a repository by tag name
      • Delete a repository's tag by name
      • List a repository's teams
      • Check if a team is assigned to a repository
      • Add a team to a repository
      • Delete a team from a repository
      • List a repo's tracked times
      • List a user's tracked times in a repo
      • Get list of topics that a repository has
      • Replace list of topics for a repository
      • Add a topic to a repository
      • Delete a topic from a repository
      • Transfer a repo ownership
      • Accept a repo transfer
      • Reject a repo transfer
      • Create a wiki page
      • Get a wiki page
      • Delete a wiki page
      • Edit a wiki page
      • Get all wiki pages
      • Get revisions of a wiki page
      • Create a repository using a template
      • Get a repository by id
      • search topics via keyword
      • Create a repository
    • settings
      • Get instance's global settings for api
      • Get instance's global settings for Attachment
      • Get instance's global settings for repositories
      • Get instance's global settings for ui
    • user
      • Get the authenticated user
      • List the authenticated user's oauth2 applications
      • creates a new OAuth2 application
      • get an OAuth2 Application
      • delete an OAuth2 Application
      • update an OAuth2 Application, this includes regenerating the client secret
      • List the authenticated user's email addresses
      • Add email addresses
      • Delete email addresses
      • List the authenticated user's followers
      • List the users that the authenticated user is following
      • Check whether a user is followed by the authenticated user
      • Follow a user
      • Unfollow a user
      • Get a Token to verify
      • Verify a GPG key
      • List the authenticated user's GPG keys
      • Create a GPG key
      • Get a GPG key
      • Remove a GPG key
      • List the authenticated user's public keys
      • Create a public key
      • Get a public key
      • Delete a public key
      • List the repos that the authenticated user owns
      • Get user settings
      • Update user settings
      • The repos that the authenticated user has starred
      • Whether the authenticated is starring the repo
      • Star the given repo
      • Unstar the given repo
      • Get list of all existing stopwatches
      • List repositories watched by the authenticated user
      • List all the teams a user belongs to
      • List the current user's tracked times
      • Search for users
      • Get a user
      • List the given user's followers
      • List the users that the given user is following
      • Check if one user is following another user
      • List the given user's GPG keys
      • Get a user's heatmap
      • List the given user's public keys
      • List the repos owned by the given user
      • The repos that the given user has starred
      • List the repositories watched by a user
      • List the authenticated user's access tokens
      • Create an access token
      • delete an access token
  • Hat拓展接口
    • repository
      • actions
        • 获取流水线文件列表
        • 获取流水线任务列表
        • 重新启动流水线任务
        • 重新启动全部流水线任务
        • 禁用流水线
        • 恢复流水线
        • 下载流水线日志
        • 启动流水线任务
      • 获取仓库所有文件文件夹
      • 获取仓库路径下所有文件文件夹
      • 仓库内搜索文件
      • 获取单个commit内容
      • 获取单个commit的dif内容
      • 创建一个webhook
      • 获取一个webhook推送历史
      • Gets the most recent non-prerelease, non-draft release of a repository, sorted by created_at
      • 获取所有的发行版
      • 获取一个发行版
      • 创建一个发行版
      • 更新一个发行版
      • 获取所有分支名称
      • 获取所有分支 (按类型分组)
      • 获取所有标签名称
      • 获取所有标签
      • 获取仓库分支、标签数量
      • 获取仓库readme文件内容
      • 获取仓库目录下readme文件内容
      • 获取所有commits(按时间分组)
      • 获取仓库贡献者
      • 获取仓库commit数量、标签数量、分支数量、发行版数量(按分支)
      • 获取文件或文件夹下的commit列表
      • 获取仓库blame内容
      • 分支、标签、commit的比较接口
      • 迁移项目(直接)
      • 获取一个合并请求
      • 获取合并请求下的commit列表
      • Get changed files for a pull request
      • 仓库下批量更改文件(创建、更新、删除)
      • 获取合并请求下所有版本记录
      • 获取合并请求下一个版本记录的diff内容
      • 获取仓库代码贡献情况
      • 获取所有分支
      • 获取仓库贡献者(包括代码行)
      • 恢复一个已删除分支
      • 获取最近的commit列表
      • 删除一个仓库
    • organization
      • 创建一个组织
      • 团队添加所有组织项目
      • 团队移除所有组织项目
      • 编辑一个组织
    • users
      • 获取用户贡献记录(按时间)
    • admin
      • 编辑一个用户
  1. notification

Mark notification threads as read, pinned or unread on a specific repo

PUT
/repos/{owner}/{repo}/notifications
notification

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Basic 之后拼接空格,以及经过 Base64 编码的 username:password
示例:
Authorization: Basic *****************
Path 参数
owner
string 
必需
owner of the repo
repo
string 
必需
name of the repo
Query 参数
all
string 
可选
If true, mark all notifications on this repo. Default value is false
status-types
array[string]
可选
Mark notifications with the provided status types. Options are: unread, read and/or pinned. Defaults to unread.
to-status
string 
可选
Status to mark notifications as. Defaults to read.
last_read_at
string 
可选
Describes the last point that notifications were checked. Anything updated since this time will not be updated.

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT '/repos///notifications' \
--header 'Authorization: Basic Og=='

返回响应

🟢205成功
application/json
Body
array of:
id
integer <int64>
可选
pinned
boolean 
可选
repository
object (Repository) 
可选
Repository represents a repository
allow_merge_commits
boolean 
可选
allow_rebase
boolean 
可选
allow_rebase_explicit
boolean 
可选
allow_rebase_update
boolean 
可选
allow_squash_merge
boolean 
可选
archived
boolean 
可选
archived_at
string <date-time>
可选
avatar_url
string 
可选
clone_url
string 
可选
created_at
string <date-time>
可选
default_allow_maintainer_edit
boolean 
可选
default_branch
string 
可选
default_delete_branch_after_merge
boolean 
可选
default_merge_style
string 
可选
description
string 
可选
empty
boolean 
可选
external_tracker
object (ExternalTracker) 
可选
ExternalTracker represents settings for external tracker
external_wiki
object (ExternalWiki) 
可选
ExternalWiki represents setting for external wiki
fork
boolean 
可选
forks_count
integer <int64>
可选
full_name
string 
可选
has_actions
boolean 
可选
has_issues
boolean 
可选
has_packages
boolean 
可选
has_projects
boolean 
可选
has_pull_requests
boolean 
可选
has_releases
boolean 
可选
has_wiki
boolean 
可选
html_url
string 
可选
id
integer <int64>
可选
ignore_whitespace_conflicts
boolean 
可选
internal
boolean 
可选
internal_tracker
object (InternalTracker) 
可选
InternalTracker represents settings for internal tracker
language
string 
可选
languages_url
string 
可选
link
string 
可选
mirror
boolean 
可选
mirror_interval
string 
可选
mirror_updated
string <date-time>
可选
name
string 
可选
open_issues_count
integer <int64>
可选
open_pr_counter
integer <int64>
可选
original_url
string 
可选
owner
object (User) 
可选
User represents a user
parent
object (Repository) 
可选
Repository represents a repository
permissions
object (Permission) 
可选
Permission represents a set of permissions
private
boolean 
可选
release_counter
integer <int64>
可选
repo_transfer
object (RepoTransfer) 
可选
RepoTransfer represents a pending repo transfer
size
integer <int64>
可选
ssh_url
string 
可选
stars_count
integer <int64>
可选
template
boolean 
可选
updated_at
string <date-time>
可选
url
string 
可选
watchers_count
integer <int64>
可选
website
string 
可选
subject
object (NotificationSubject) 
可选
NotificationSubject contains the notification subject (Issue/Pull/Commit)
html_url
string 
可选
latest_comment_html_url
string 
可选
latest_comment_url
string 
可选
state
string 
可选
StateType issue state type
title
string 
可选
type
string 
可选
NotifySubjectType represent type of notification subject
url
string 
可选
unread
boolean 
可选
updated_at
string <date-time>
可选
url
string 
可选
示例
[
  {
    "id": 0,
    "pinned": true,
    "repository": {
      "allow_merge_commits": true,
      "allow_rebase": true,
      "allow_rebase_explicit": true,
      "allow_rebase_update": true,
      "allow_squash_merge": true,
      "archived": true,
      "archived_at": "2019-08-24T14:15:22Z",
      "avatar_url": "string",
      "clone_url": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "default_allow_maintainer_edit": true,
      "default_branch": "string",
      "default_delete_branch_after_merge": true,
      "default_merge_style": "string",
      "description": "string",
      "empty": true,
      "external_tracker": {
        "external_tracker_format": "string",
        "external_tracker_regexp_pattern": "string",
        "external_tracker_style": "string",
        "external_tracker_url": "string"
      },
      "external_wiki": {
        "external_wiki_url": "string"
      },
      "fork": true,
      "forks_count": 0,
      "full_name": "string",
      "has_actions": true,
      "has_issues": true,
      "has_packages": true,
      "has_projects": true,
      "has_pull_requests": true,
      "has_releases": true,
      "has_wiki": true,
      "html_url": "string",
      "id": 0,
      "ignore_whitespace_conflicts": true,
      "internal": true,
      "internal_tracker": {
        "allow_only_contributors_to_track_time": true,
        "enable_issue_dependencies": true,
        "enable_time_tracker": true
      },
      "language": "string",
      "languages_url": "string",
      "link": "string",
      "mirror": true,
      "mirror_interval": "string",
      "mirror_updated": "2019-08-24T14:15:22Z",
      "name": "string",
      "open_issues_count": 0,
      "open_pr_counter": 0,
      "original_url": "string",
      "owner": {
        "active": true,
        "avatar_url": "string",
        "created": "2019-08-24T14:15:22Z",
        "description": "string",
        "email": "user@example.com",
        "followers_count": 0,
        "following_count": 0,
        "full_name": "string",
        "id": 0,
        "is_admin": true,
        "language": "string",
        "last_login": "2019-08-24T14:15:22Z",
        "location": "string",
        "login": "string",
        "login_name": "empty",
        "prohibit_login": true,
        "restricted": true,
        "starred_repos_count": 0,
        "visibility": "string",
        "website": "string"
      },
      "parent": {},
      "permissions": {
        "admin": true,
        "pull": true,
        "push": true
      },
      "private": true,
      "release_counter": 0,
      "repo_transfer": {
        "doer": {
          "active": true,
          "avatar_url": "string",
          "created": "2019-08-24T14:15:22Z",
          "description": "string",
          "email": "user@example.com",
          "followers_count": 0,
          "following_count": 0,
          "full_name": "string",
          "id": 0,
          "is_admin": true,
          "language": "string",
          "last_login": "2019-08-24T14:15:22Z",
          "location": "string",
          "login": "string",
          "login_name": "empty",
          "prohibit_login": true,
          "restricted": true,
          "starred_repos_count": 0,
          "visibility": "string",
          "website": "string"
        },
        "recipient": {
          "active": true,
          "avatar_url": "string",
          "created": "2019-08-24T14:15:22Z",
          "description": "string",
          "email": "user@example.com",
          "followers_count": 0,
          "following_count": 0,
          "full_name": "string",
          "id": 0,
          "is_admin": true,
          "language": "string",
          "last_login": "2019-08-24T14:15:22Z",
          "location": "string",
          "login": "string",
          "login_name": "empty",
          "prohibit_login": true,
          "restricted": true,
          "starred_repos_count": 0,
          "visibility": "string",
          "website": "string"
        },
        "teams": [
          {
            "can_create_org_repo": true,
            "description": "string",
            "id": 0,
            "includes_all_repositories": true,
            "name": "string",
            "organization": {
              "avatar_url": "string",
              "description": "string",
              "email": "string",
              "full_name": "string",
              "id": 0,
              "location": "string",
              "name": "string",
              "repo_admin_change_team_access": true,
              "username": "string",
              "visibility": "string",
              "website": "string"
            },
            "permission": "none",
            "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"
            }
          }
        ]
      },
      "size": 0,
      "ssh_url": "string",
      "stars_count": 0,
      "template": true,
      "updated_at": "2019-08-24T14:15:22Z",
      "url": "string",
      "watchers_count": 0,
      "website": "string"
    },
    "subject": {
      "html_url": "string",
      "latest_comment_html_url": "string",
      "latest_comment_url": "string",
      "state": "string",
      "title": "string",
      "type": "string",
      "url": "string"
    },
    "unread": true,
    "updated_at": "2019-08-24T14:15:22Z",
    "url": "string"
  }
]
上一页
List users's notification threads on a specific repo
下一页
Create a repository in an organization
Built with