Gitea API.
  1. repository
Gitea API.
  • admin
    • List cron tasks
    • Run cron task
    • List all organizations
    • List unadopted repositories
    • Delete unadopted files
    • Adopt unadopted files as a repository
    • List all users
    • 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
    • Get default signing-key.gpg
    • Returns the version of the Gitea application
  • notification
    • List users's notification threads
    • Mark notification threads as read, pinned or unread
    • Check if unread notifications exist
    • Get notification thread by ID
    • Mark notification thread as read by ID
    • List users's notification threads on a specific repo
    • Mark notification threads as read, pinned or unread on a specific repo
  • organization
    • Create a repository in an organization
    • Get list of organizations
    • Create an organization
    • Delete an organization
    • Get an organization
    • Edit an organization
    • List an organization's webhooks
    • Create a hook
    • Delete a hook
    • Get a hook
    • Update a hook
    • List an organization's labels
    • Create a label for an organization
    • Delete a label
    • Get a single label
    • Update a label
    • List an organization's members
    • Remove a member from an organization
    • Check if a user is a member of an organization
    • List an organization's public members
    • Conceal a user's membership
    • Check if a user is a public member of an organization
    • Publicize 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
    • Delete a team
    • Get a team
    • Edit a team
    • List a team's members
    • Remove a team member
    • List a particular member of team
    • Add a team member
    • List a team's repos
    • Remove a repository from a team
    • Add a repository to a team
    • List the current user's organizations
    • List a user's organizations
  • 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
    • Delete a comment
    • Get a comment
    • Edit a comment
    • Remove a reaction from a comment of an issue
    • Get a list of reactions from a comment of an issue
    • Add a reaction to a comment of an issue
    • Get 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.
    • Remove all labels from an issue
    • Get an issue's labels
    • Add a label to an issue
    • Replace an issue's labels
    • Remove a label from an issue
    • Remove a reaction from an issue
    • Get a list reactions of an issue
    • Add a reaction to 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
    • Unsubscribe user from issue
    • Subscribe user to issue
    • Reset a tracked time of an issue
    • List an issue's tracked times
    • Add tracked time to a issue
    • Delete specific tracked time
    • Get all of a repository's labels
    • Create a label
    • Delete a label
    • Get a single label
    • Update a label
    • Get all of a repository's opened milestones
    • Create a milestone
    • Delete a milestone
    • Get a milestone
    • Update a milestone
  • repository
    • Migrate a remote git repository
      POST
    • Search for repositories
      GET
    • Delete a repository
      DELETE
    • Get a repository
      GET
    • Edit a repository's properties. Only fields that are set will be changed.
      PATCH
    • Get an archive of a repository
      GET
    • Return all users that have write access and can be assigned to issues
      GET
    • List branch protections for a repository
      GET
    • Create a branch protections for a repository
      POST
    • Delete a specific branch protection for the repository
      DELETE
    • Get a specific branch protection for the repository
      GET
    • Edit a branch protections for a repository. Only fields that are set will be changed
      PATCH
    • List a repository's branches
      GET
    • Create a branch
      POST
    • Delete a specific branch from a repository
      DELETE
    • Retrieve a specific branch from a repository, including its effective branch protection
      GET
    • List a repository's collaborators
      GET
    • Delete a collaborator from a repository
      DELETE
    • Check if a user is a collaborator of a repository
      GET
    • Add a collaborator to a repository
      PUT
    • Get a list of all commits from a repository
      GET
    • Get a commit's combined status, by branch/tag/commit reference
      GET
    • Get a commit's statuses, by branch/tag/commit reference
      GET
    • Gets the metadata of all the entries of the root dir
      GET
    • Delete a file in a repository
      DELETE
    • Gets the metadata and contents (if a file) of an entry in a repository, or a list of entries if a dir
      GET
    • Create a file in a repository
      POST
    • Update a file in a repository
      PUT
    • Get the EditorConfig definitions of a file in a repository
      GET
    • List a repository's forks
      GET
    • Fork a repository
      POST
    • Gets the blob of a repository.
      GET
    • Get a single commit from a repository
      GET
    • Get a note corresponding to a single commit from a repository
      GET
    • Get specified ref or filtered repository's refs
      GET
    • Get specified ref or filtered repository's refs
      GET
    • Gets the tag object of an annotated tag (not lightweight tags)
      GET
    • Gets the tree of a repository.
      GET
    • List the hooks in a repository
      GET
    • Create a hook
      POST
    • List the Git hooks in a repository
      GET
    • Delete a Git hook in a repository
      DELETE
    • Get a Git hook
      GET
    • Edit a Git hook in a repository
      PATCH
    • Delete a hook in a repository
      DELETE
    • Get a hook
      GET
    • Edit a hook in a repository
      PATCH
    • Test a push webhook
      POST
    • Get available issue templates for a repository
      GET
    • List a repository's keys
      GET
    • Add a key to a repository
      POST
    • Delete a key from a repository
      DELETE
    • Get a repository's key by id
      GET
    • Get languages and number of bytes of code written
      GET
    • Sync a mirrored repository
      POST
    • List a repo's pull requests
      GET
    • Create a pull request
      POST
    • Get a pull request
      GET
    • Update a pull request. If using deadline only the date will be taken into account, and time of day ignored.
      PATCH
    • Get a pull request diff
      GET
    • Get a pull request patch file
      GET
    • Get commits for a pull request
      GET
    • Check if a pull request has been merged
      GET
    • Merge a pull request
      POST
    • cancel review requests for a pull request
      DELETE
    • create review requests for a pull request
      POST
    • List all reviews for a pull request
      GET
    • Create a review to an pull request
      POST
    • Delete a specific review from a pull request
      DELETE
    • Get a specific review for a pull request
      GET
    • Submit a pending review to an pull request
      POST
    • Get a specific review for a pull request
      GET
    • Dismiss a review for a pull request
      POST
    • Cancel to dismiss a review for a pull request
      POST
    • Merge PR's baseBranch into headBranch
      POST
    • Get a file from a repository
      GET
    • List a repo's releases
      GET
    • Create a release
      POST
    • Delete a release by tag name
      DELETE
    • Get a release by tag name
      GET
    • Delete a release
      DELETE
    • Get a release
      GET
    • Update a release
      PATCH
    • List release's attachments
      GET
    • Create a release attachment
      POST
    • Delete a release attachment
      DELETE
    • Get a release attachment
      GET
    • Edit a release attachment
      PATCH
    • Return all users that can be requested to review in this repo
      GET
    • Get signing-key.gpg for given repository
      GET
    • List a repo's stargazers
      GET
    • Get a commit's statuses
      GET
    • Create a commit status
      POST
    • List a repo's watchers
      GET
    • Unwatch a repo
      DELETE
    • Check if the current user is watching a repo
      GET
    • Watch a repo
      PUT
    • List a repository's tags
      GET
    • Create a new git tag in a repository
      POST
    • Delete a repository's tag by name
      DELETE
    • Get the tag of a repository by tag name
      GET
    • List a repository's teams
      GET
    • Delete a team from a repository
      DELETE
    • Check if a team is assigned to a repository
      GET
    • Add a team to a repository
      PUT
    • List a repo's tracked times
      GET
    • List a user's tracked times in a repo
      GET
    • Get list of topics that a repository has
      GET
    • Replace list of topics for a repository
      PUT
    • Delete a topic from a repository
      DELETE
    • Add a topic to a repository
      PUT
    • Transfer a repo ownership
      POST
    • Create a repository using a template
      POST
    • Get a repository by id
      GET
    • search topics via keyword
      GET
    • Create a repository
      POST
  • 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
    • delete an OAuth2 Application
    • get an OAuth2 Application
    • update an OAuth2 Application, this includes regenerating the client secret
    • Delete email addresses
    • List the authenticated user's email addresses
    • Add email addresses
    • List the authenticated user's followers
    • List the users that the authenticated user is following
    • Unfollow a user
    • Check whether a user is followed by the authenticated user
    • Follow a user
    • Get a Token to verify
    • Verify a GPG key
    • List the authenticated user's GPG keys
    • Create a GPG key
    • Remove a GPG key
    • Get a GPG key
    • List the authenticated user's public keys
    • Create a public key
    • Delete a public key
    • Get 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
    • Unstar the given repo
    • Whether the authenticated is starring the repo
    • Star 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
    • Check if one user is following another user
    • Get a user
    • List the given user's followers
    • List the users that the given user is following
    • 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
  1. repository

Update a release

PATCH
/repos/{owner}/{repo}/releases/{id}
repository
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH '/api/v1/repos///releases/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "body": "string",
    "draft": true,
    "name": "string",
    "prerelease": true,
    "tag_name": "string",
    "target_commitish": "string"
}'
Response Response Example
200 - Example 1
{
    "assets": [
        {
            "browser_download_url": "string",
            "created_at": "2019-08-24T14:15:22Z",
            "download_count": 0,
            "id": 0,
            "name": "string",
            "size": 0,
            "uuid": "string"
        }
    ],
    "author": {
        "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",
        "prohibit_login": true,
        "restricted": true,
        "starred_repos_count": 0,
        "visibility": "string",
        "website": "string"
    },
    "body": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "draft": true,
    "html_url": "string",
    "id": 0,
    "name": "string",
    "prerelease": true,
    "published_at": "2019-08-24T14:15:22Z",
    "tag_name": "string",
    "tarball_url": "string",
    "target_commitish": "string",
    "url": "string",
    "zipball_url": "string"
}

Request

Path Params
owner
string 
required
owner of the repo
repo
string 
required
name of the repo
id
integer 
required
id of the release to edit
Body Params application/json
EditReleaseOption options when editing a release
body
string 
optional
draft
boolean 
optional
name
string 
optional
prerelease
boolean 
optional
tag_name
string 
optional
target_commitish
string 
optional
Examples

Responses

🟢200OK
application/json
Body
Release represents a repository release
assets
array[object (Attachment) {7}] 
optional
browser_download_url
string 
optional
created_at
string <date-time>
optional
download_count
integer <int64>
optional
id
integer <int64>
optional
name
string 
optional
size
integer <int64>
optional
uuid
string 
optional
author
object (User) 
optional
User represents a user
active
boolean 
optional
Is user active
avatar_url
string 
optional
URL to the user's avatar
created
string <date-time>
optional
description
string 
optional
the user's description
email
string <email>
optional
followers_count
integer <int64>
optional
user counts
following_count
integer <int64>
optional
full_name
string 
optional
the user's full name
id
integer <int64>
optional
the user's id
is_admin
boolean 
optional
Is the user an administrator
language
string 
optional
User locale
last_login
string <date-time>
optional
location
string 
optional
the user's location
login
string 
optional
the user's username
prohibit_login
boolean 
optional
Is user login prohibited
restricted
boolean 
optional
Is user restricted
starred_repos_count
integer <int64>
optional
visibility
string 
optional
User visibility level option: public, limited, private
website
string 
optional
the user's website
body
string 
optional
created_at
string <date-time>
optional
draft
boolean 
optional
html_url
string 
optional
id
integer <int64>
optional
name
string 
optional
prerelease
boolean 
optional
published_at
string <date-time>
optional
tag_name
string 
optional
tarball_url
string 
optional
target_commitish
string 
optional
url
string 
optional
zipball_url
string 
optional
🟠404404
Modified at 2022-09-10 23:12:53
Previous
Get a release
Next
List release's attachments
Built with