Gitea

App · 23 actions

Work with Gitea, Forgejo and Codeberg repositories: open, change and comment on issues, open and merge pull requests, publish releases, read and save files, and manage branches. Start a workflow for each new issue, pull request or release.

Actions

ActionWhat it does
Add commentComment on an issue or pull request.
Change issueChange an issue or pull request: close or reopen it, rename it, or change its description, labels, assignees, milestone or due date.
Create branchCreate a branch from another branch, or from the default one.
Create issueOpen an issue, with labels, assignees, a milestone and a due date if you like.
Create pull requestOpen a pull request to merge one branch into another.
Create releasePublish a release, creating its tag from a branch if the tag does not exist yet.
Create repositoryCreate a repository for you or one of your organizations, private and with a README by default.
Delete branchDelete a branch.
Delete repositoryDelete a repository for good, with its issues, pull requests and releases.
Get fileRead a file's text from a repository, on a branch or the default one.
Get issueGet one issue or pull request by its number.
Get latest releaseGet the newest published release that is not a draft or a pre-release.
Get pull requestGet one pull request: its branches, and whether it is merged or can be merged.
Get repositoryGet a repository's details: its default branch and counts of open issues and pull requests.
List branchesList a repository's branches with each one's latest commit.
List commentsList the comments on an issue or pull request, oldest first.
List issuesList a repository's issues, newest first, by state, labels, words or last change.
List labelsList the labels a repository's issues and pull requests can carry.
List pull requestsList a repository's pull requests by state.
List releasesList a repository's releases, newest first.
List repositoriesList your repositories, or search every repository you can see by words in its name or description.
Merge pull requestMerge a pull request, by a merge commit, a squash, a rebase or a fast-forward.
Save fileCreate a file, or replace its text, as one commit on a branch or the default one.

Add comment

Comment on an issue or pull request.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
Issue numberissue_numbertextRequired
The issue's or pull request's number, such as 42.
CommentbodytextRequired
The comment, in Markdown.

Outputs

authortext
Who wrote it
bodytext
Its text, in Markdown
created_attext
When it was written (ISO 8601)
html_urltext
Its address
idnumber
The comment's ID
updated_attext
When it was last edited (ISO 8601)
Example output
{
  "author": "sam",
  "body": "Fixed in #43.",
  "created_at": "2026-10-21T09:00:00Z",
  "html_url": "https://gitea.example.com/acme/website/issues/42#issuecomment-901",
  "id": 901,
  "updated_at": "2026-10-21T09:00:00Z"
}

Change issue

Change an issue or pull request: close or reopen it, rename it, or change its description, labels, assignees, milestone or due date. Empty fields are left as they are.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
Issue numberissue_numbertextRequired
The issue's or pull request's number, such as 42.
Statestatetext
Close or reopen it.One of: open, closed.
Titletitletext
A new title.
Descriptionbodytext
A new description, in Markdown.
Labelslabelslist
Its labels, replacing the ones it has.
Assigneesassigneeslist
People to assign, by user name.
Milestonemilestonetext
The milestone, by its title.
Due datedue_datedate
When it is due.

Outputs

assigneeslist
Who it is assigned to
authortext
Who opened it
bodytext
Its description, in Markdown
closed_attext
When it was closed (ISO 8601); empty when open
commentsnumber
How many comments it has
created_attext
When it was opened (ISO 8601)
due_datetext
When it is due (ISO 8601); empty when not set
html_urltext
Its page
labelslist
Its labels' names
milestonetext
Its milestone's title; empty when none
numbernumber
Its number in the repository
statetext
open or closed
titletext
Its title
updated_attext
When it last changed (ISO 8601)
Example output
{
  "assignees": [
    "sam"
  ],
  "author": "jo",
  "body": "The 'Contact sales' link goes nowhere.",
  "closed_at": "2026-10-22T09:00:00Z",
  "comments": 2,
  "created_at": "2026-10-20T09:00:00Z",
  "due_date": "2026-10-31T00:00:00Z",
  "html_url": "https://gitea.example.com/acme/website/issues/42",
  "labels": [
    "bug"
  ],
  "milestone": "October",
  "number": 42,
  "state": "closed",
  "title": "Broken link on the pricing page",
  "updated_at": "2026-10-21T09:00:00Z"
}

Create branch

Create a branch from another branch, or from the default one.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
New branchbranchtextRequired
The new branch's name.
Fromfrom_branchtext
The branch to start from. Leave empty for the default branch.

Outputs

commit_messagetext
That commit's message
commit_shatext
Its latest commit
nametext
The branch's name
protectedtrue/false
True when it is protected
Example output
{
  "commit_message": "Fix the pricing link",
  "commit_sha": "4f2a9c1d8e7b6a5f4e3d2c1b0a9f8e7d6c5b4a39",
  "name": "fix-link",
  "protected": false
}

Create issue

Open an issue, with labels, assignees, a milestone and a due date if you like.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
TitletitletextRequired
The issue's title.
Descriptionbodytext
What it is about, in Markdown.
Labelslabelslist
Labels to add.
Assigneesassigneeslist
People to assign, by user name.
Milestonemilestonetext
The milestone, by its title.
Due datedue_datedate
When it is due.

Outputs

assigneeslist
Who it is assigned to
authortext
Who opened it
bodytext
Its description, in Markdown
closed_attext
When it was closed (ISO 8601); empty when open
commentsnumber
How many comments it has
created_attext
When it was opened (ISO 8601)
due_datetext
When it is due (ISO 8601); empty when not set
html_urltext
Its page
labelslist
Its labels' names
milestonetext
Its milestone's title; empty when none
numbernumber
Its number in the repository
statetext
open or closed
titletext
Its title
updated_attext
When it last changed (ISO 8601)
Example output
{
  "assignees": [
    "sam"
  ],
  "author": "jo",
  "body": "The 'Contact sales' link goes nowhere.",
  "closed_at": "",
  "comments": 2,
  "created_at": "2026-10-20T09:00:00Z",
  "due_date": "2026-10-31T00:00:00Z",
  "html_url": "https://gitea.example.com/acme/website/issues/42",
  "labels": [
    "bug"
  ],
  "milestone": "October",
  "number": 42,
  "state": "open",
  "title": "Broken link on the pricing page",
  "updated_at": "2026-10-21T09:00:00Z"
}

Create pull request

Open a pull request to merge one branch into another.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
From branchheadtextRequired
The branch with the changes.
Into branchbasetextRequired
The branch to merge into, such as main.
TitletitletextRequired
The pull request's title.
Descriptionbodytext
What it changes, in Markdown.

Outputs

assigneeslist
Who it is assigned to
authortext
Who opened it
base_branchtext
The branch it merges into
bodytext
Its description, in Markdown
closed_attext
When it was closed (ISO 8601); empty when open
commentsnumber
How many comments it has
created_attext
When it was opened (ISO 8601)
drafttrue/false
True while marked work in progress
due_datetext
When it is due (ISO 8601); empty when not set
head_branchtext
The branch with the changes
html_urltext
Its page
labelslist
Its labels' names
mergeabletrue/false
True when it can be merged without conflicts
mergedtrue/false
True once merged
merged_attext
When it was merged (ISO 8601); empty when not
merged_bytext
Who merged it
milestonetext
Its milestone's title; empty when none
numbernumber
Its number in the repository
statetext
open or closed
titletext
Its title
updated_attext
When it last changed (ISO 8601)
Example output
{
  "assignees": [
    "sam"
  ],
  "author": "jo",
  "base_branch": "main",
  "body": "The 'Contact sales' link goes nowhere.",
  "closed_at": "",
  "comments": 2,
  "created_at": "2026-10-20T09:00:00Z",
  "draft": false,
  "due_date": "2026-10-31T00:00:00Z",
  "head_branch": "fix-link",
  "html_url": "https://gitea.example.com/acme/website/pulls/43",
  "labels": [
    "bug"
  ],
  "mergeable": true,
  "merged": false,
  "merged_at": "",
  "merged_by": "",
  "milestone": "October",
  "number": 43,
  "state": "open",
  "title": "Fix the pricing link",
  "updated_at": "2026-10-21T09:00:00Z"
}

Create release

Publish a release, creating its tag from a branch if the tag does not exist yet.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
Tagtag_nametextRequired
The release's tag, such as v1.2.0.
From branchtargettext
The branch to tag when the tag is new. Leave empty for the default branch.
Titlenametext
The release's title. Defaults to the tag.
Release notesnotestext
What is in it, in Markdown.
Draftdrafttrue/false
Save it as a draft rather than publishing it. Off by default.Default: false.
Pre-releaseprereleasetrue/false
Mark it as a pre-release. Off by default.Default: false.

Outputs

assetslist
Files attached to the release
authortext
Who published it
bodytext
Its release notes, in Markdown
created_attext
When it was created (ISO 8601)
drafttrue/false
True while it is a draft
html_urltext
Its page
idnumber
The release's ID
nametext
Its title
prereleasetrue/false
True when it is a pre-release
published_attext
When it was published (ISO 8601)
tag_nametext
Its tag, such as v1.2.0
targettext
The branch or commit the tag was made from
Example output
{
  "assets": [],
  "author": "sam",
  "body": "New pricing page.",
  "created_at": "2026-10-22T09:00:00Z",
  "draft": false,
  "html_url": "https://gitea.example.com/acme/website/releases/tag/v1.2.0",
  "id": 77,
  "name": "v1.2.0",
  "prerelease": false,
  "published_at": "2026-10-22T09:00:00Z",
  "tag_name": "v1.2.0",
  "target": "main"
}

Create repository

Create a repository for you or one of your organizations, private and with a README by default.

Inputs

NamenametextRequired
The repository's name: letters, digits, '-', '_' and '.'.
Descriptiondescriptiontext
A short description.
Privateprivatetrue/false
Only members can see it. On by default.Default: true.
Organizationorganizationtext
Create it in this organization. Leave empty for your own account.
Add a READMEadd_readmetrue/false
Start it with a README, so it has a default branch. On by default.Default: true.

Outputs

archivedtrue/false
True when it is archived (read-only)
clone_urltext
The address to clone it from
created_attext
When it was created (ISO 8601)
default_branchtext
Its default branch, such as main
descriptiontext
Its description
forktrue/false
True when it is a fork
forksnumber
How many forks it has
full_nametext
owner/name
html_urltext
Its page
nametext
The repository's name
open_issuesnumber
How many issues are open
open_pull_requestsnumber
How many pull requests are open
ownertext
The user or organization that owns it
privatetrue/false
True when only members can see it
starsnumber
How many stars it has
updated_attext
When it last changed (ISO 8601)
Example output
{
  "archived": false,
  "clone_url": "https://gitea.example.com/acme/website.git",
  "created_at": "2026-01-05T10:00:00Z",
  "default_branch": "main",
  "description": "Our website",
  "fork": false,
  "forks": 1,
  "full_name": "acme/website",
  "html_url": "https://gitea.example.com/acme/website",
  "name": "website",
  "open_issues": 3,
  "open_pull_requests": 1,
  "owner": "acme",
  "private": false,
  "stars": 4,
  "updated_at": "2026-10-20T09:00:00Z"
}

Delete branch

Delete a branch. Gitea refuses for a protected or default branch.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
BranchbranchtextRequired
The branch to delete.

Outputs

branchtext
The branch deleted
deletedtrue/false
True once deleted
Example output
{
  "branch": "fix-link",
  "deleted": true
}

Delete repository

Delete a repository for good, with its issues, pull requests and releases. It cannot be undone.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.

Outputs

deletedtrue/false
True once deleted
repositorytext
The repository deleted
Example output
{
  "deleted": true,
  "repository": "acme/old-site"
}

Get file

Read a file's text from a repository, on a branch or the default one.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
File pathpathtextRequired
The file's path in the repository, such as docs/README.md.
Branchbranchtext
The branch to read from. Leave empty for the default branch.

Outputs

contenttext
Its text; empty when it is not text
download_urltext
Its raw download address
html_urltext
Its page
is_texttrue/false
True when the file is text
pathtext
The file's path
shatext
The file's SHA, which changes with every edit
sizenumber
Its size in bytes
Example output
{
  "content": "Hello there\n",
  "download_url": "https://gitea.example.com/acme/website/raw/branch/main/docs/README.md",
  "html_url": "https://gitea.example.com/acme/website/src/branch/main/docs/README.md",
  "is_text": true,
  "path": "docs/README.md",
  "sha": "e6f1b6c3d1bf880d606379609238c57fe60016db",
  "size": 12
}

Get issue

Get one issue or pull request by its number.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
Issue numberissue_numbertextRequired
The issue's or pull request's number, such as 42.

Outputs

assigneeslist
Who it is assigned to
authortext
Who opened it
bodytext
Its description, in Markdown
closed_attext
When it was closed (ISO 8601); empty when open
commentsnumber
How many comments it has
created_attext
When it was opened (ISO 8601)
due_datetext
When it is due (ISO 8601); empty when not set
html_urltext
Its page
labelslist
Its labels' names
milestonetext
Its milestone's title; empty when none
numbernumber
Its number in the repository
statetext
open or closed
titletext
Its title
updated_attext
When it last changed (ISO 8601)
Example output
{
  "assignees": [
    "sam"
  ],
  "author": "jo",
  "body": "The 'Contact sales' link goes nowhere.",
  "closed_at": "",
  "comments": 2,
  "created_at": "2026-10-20T09:00:00Z",
  "due_date": "2026-10-31T00:00:00Z",
  "html_url": "https://gitea.example.com/acme/website/issues/42",
  "labels": [
    "bug"
  ],
  "milestone": "October",
  "number": 42,
  "state": "open",
  "title": "Broken link on the pricing page",
  "updated_at": "2026-10-21T09:00:00Z"
}

Get latest release

Get the newest published release that is not a draft or a pre-release.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.

Outputs

assetslist
Files attached to the release
authortext
Who published it
bodytext
Its release notes, in Markdown
created_attext
When it was created (ISO 8601)
drafttrue/false
True while it is a draft
html_urltext
Its page
idnumber
The release's ID
nametext
Its title
prereleasetrue/false
True when it is a pre-release
published_attext
When it was published (ISO 8601)
tag_nametext
Its tag, such as v1.2.0
targettext
The branch or commit the tag was made from
Example output
{
  "assets": [],
  "author": "sam",
  "body": "New pricing page.",
  "created_at": "2026-10-22T09:00:00Z",
  "draft": false,
  "html_url": "https://gitea.example.com/acme/website/releases/tag/v1.2.0",
  "id": 77,
  "name": "v1.2.0",
  "prerelease": false,
  "published_at": "2026-10-22T09:00:00Z",
  "tag_name": "v1.2.0",
  "target": "main"
}

Get pull request

Get one pull request: its branches, and whether it is merged or can be merged.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
Pull request numberpull_numbertextRequired
The pull request's number, such as 42.

Outputs

assigneeslist
Who it is assigned to
authortext
Who opened it
base_branchtext
The branch it merges into
bodytext
Its description, in Markdown
closed_attext
When it was closed (ISO 8601); empty when open
commentsnumber
How many comments it has
created_attext
When it was opened (ISO 8601)
drafttrue/false
True while marked work in progress
due_datetext
When it is due (ISO 8601); empty when not set
head_branchtext
The branch with the changes
html_urltext
Its page
labelslist
Its labels' names
mergeabletrue/false
True when it can be merged without conflicts
mergedtrue/false
True once merged
merged_attext
When it was merged (ISO 8601); empty when not
merged_bytext
Who merged it
milestonetext
Its milestone's title; empty when none
numbernumber
Its number in the repository
statetext
open or closed
titletext
Its title
updated_attext
When it last changed (ISO 8601)
Example output
{
  "assignees": [
    "sam"
  ],
  "author": "jo",
  "base_branch": "main",
  "body": "The 'Contact sales' link goes nowhere.",
  "closed_at": "",
  "comments": 2,
  "created_at": "2026-10-20T09:00:00Z",
  "draft": false,
  "due_date": "2026-10-31T00:00:00Z",
  "head_branch": "fix-link",
  "html_url": "https://gitea.example.com/acme/website/pulls/43",
  "labels": [
    "bug"
  ],
  "mergeable": true,
  "merged": false,
  "merged_at": "",
  "merged_by": "",
  "milestone": "October",
  "number": 43,
  "state": "open",
  "title": "Fix the pricing link",
  "updated_at": "2026-10-21T09:00:00Z"
}

Get repository

Get a repository's details: its default branch and counts of open issues and pull requests.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.

Outputs

archivedtrue/false
True when it is archived (read-only)
clone_urltext
The address to clone it from
created_attext
When it was created (ISO 8601)
default_branchtext
Its default branch, such as main
descriptiontext
Its description
forktrue/false
True when it is a fork
forksnumber
How many forks it has
full_nametext
owner/name
html_urltext
Its page
nametext
The repository's name
open_issuesnumber
How many issues are open
open_pull_requestsnumber
How many pull requests are open
ownertext
The user or organization that owns it
privatetrue/false
True when only members can see it
starsnumber
How many stars it has
updated_attext
When it last changed (ISO 8601)
Example output
{
  "archived": false,
  "clone_url": "https://gitea.example.com/acme/website.git",
  "created_at": "2026-01-05T10:00:00Z",
  "default_branch": "main",
  "description": "Our website",
  "fork": false,
  "forks": 1,
  "full_name": "acme/website",
  "html_url": "https://gitea.example.com/acme/website",
  "name": "website",
  "open_issues": 3,
  "open_pull_requests": 1,
  "owner": "acme",
  "private": false,
  "stars": 4,
  "updated_at": "2026-10-20T09:00:00Z"
}

List branches

List a repository's branches with each one's latest commit.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.

Outputs

brancheslist
The branches
countnumber
How many
Example output
{
  "branches": [
    {
      "commit_message": "Fix the pricing link",
      "commit_sha": "4f2a9c1d8e7b6a5f4e3d2c1b0a9f8e7d6c5b4a39",
      "name": "fix-link",
      "protected": false
    }
  ],
  "count": 1
}

List comments

List the comments on an issue or pull request, oldest first.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
Issue numberissue_numbertextRequired
The issue's or pull request's number, such as 42.

Outputs

commentslist
The comments
countnumber
How many
Example output
{
  "comments": [
    {
      "author": "sam",
      "body": "Fixed in #43.",
      "created_at": "2026-10-21T09:00:00Z",
      "html_url": "https://gitea.example.com/acme/website/issues/42#issuecomment-901",
      "id": 901,
      "updated_at": "2026-10-21T09:00:00Z"
    }
  ],
  "count": 1
}

List issues

List a repository's issues, newest first, by state, labels, words or last change.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
Statestatetext
Which issues. Defaults to open.One of: open, closed, all (Open and closed). Default: open.
Labelslabelslist
Only issues with all of these labels.
Search forsearchtext
Only issues with these words.
Changed sincesincedate and time
Only issues changed after this moment.
Page sizelimitnumber
How many to return, up to 50. Defaults to 30.From 1 to 50.
Pagepagenumber
Which page, from 1. Use it when 'has_more' was true.At least 1.

Outputs

countnumber
How many were returned
has_moretrue/false
True when there may be another page
issueslist
The issues
pagenumber
The page returned
Example output
{
  "count": 1,
  "has_more": false,
  "issues": [
    {
      "assignees": [
        "sam"
      ],
      "author": "jo",
      "body": "The 'Contact sales' link goes nowhere.",
      "closed_at": "",
      "comments": 2,
      "created_at": "2026-10-20T09:00:00Z",
      "due_date": "2026-10-31T00:00:00Z",
      "html_url": "https://gitea.example.com/acme/website/issues/42",
      "labels": [
        "bug"
      ],
      "milestone": "October",
      "number": 42,
      "state": "open",
      "title": "Broken link on the pricing page",
      "updated_at": "2026-10-21T09:00:00Z"
    }
  ],
  "page": 1
}

List labels

List the labels a repository's issues and pull requests can carry.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.

Outputs

countnumber
How many
labelslist
The labels
Example output
{
  "count": 1,
  "labels": [
    {
      "color": "e11d21",
      "description": "Something is broken",
      "id": 5,
      "name": "bug"
    }
  ]
}

List pull requests

List a repository's pull requests by state.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
Statestatetext
Which pull requests. Defaults to open.One of: open, closed, all (Open and closed). Default: open.
Ordersorttext
Defaults to recently updated first.One of: recentupdate (Recently updated first), oldest (Oldest first), leastupdate (Least recently updated first), mostcomment (Most commented first). Default: recentupdate.
Page sizelimitnumber
How many to return, up to 50. Defaults to 30.From 1 to 50.
Pagepagenumber
Which page, from 1. Use it when 'has_more' was true.At least 1.

Outputs

countnumber
How many were returned
has_moretrue/false
True when there may be another page
pagenumber
The page returned
pull_requestslist
The pull requests
Example output
{
  "count": 1,
  "has_more": false,
  "page": 1,
  "pull_requests": [
    {
      "assignees": [
        "sam"
      ],
      "author": "jo",
      "base_branch": "main",
      "body": "The 'Contact sales' link goes nowhere.",
      "closed_at": "",
      "comments": 2,
      "created_at": "2026-10-20T09:00:00Z",
      "draft": false,
      "due_date": "2026-10-31T00:00:00Z",
      "head_branch": "fix-link",
      "html_url": "https://gitea.example.com/acme/website/pulls/43",
      "labels": [
        "bug"
      ],
      "mergeable": true,
      "merged": false,
      "merged_at": "",
      "merged_by": "",
      "milestone": "October",
      "number": 43,
      "state": "open",
      "title": "Fix the pricing link",
      "updated_at": "2026-10-21T09:00:00Z"
    }
  ]
}

List releases

List a repository's releases, newest first.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
Page sizelimitnumber
How many to return, up to 50. Defaults to 30.From 1 to 50.
Pagepagenumber
Which page, from 1. Use it when 'has_more' was true.At least 1.

Outputs

countnumber
How many were returned
has_moretrue/false
True when there may be another page
pagenumber
The page returned
releaseslist
The releases
Example output
{
  "count": 1,
  "has_more": false,
  "page": 1,
  "releases": [
    {
      "assets": [],
      "author": "sam",
      "body": "New pricing page.",
      "created_at": "2026-10-22T09:00:00Z",
      "draft": false,
      "html_url": "https://gitea.example.com/acme/website/releases/tag/v1.2.0",
      "id": 77,
      "name": "v1.2.0",
      "prerelease": false,
      "published_at": "2026-10-22T09:00:00Z",
      "tag_name": "v1.2.0",
      "target": "main"
    }
  ]
}

List repositories

List your repositories, or search every repository you can see by words in its name or description.

Inputs

Search forsearchtext
Words to search for. Leave empty to list your own repositories (needs a token).
Page sizelimitnumber
How many to return, up to 50. Defaults to 30.From 1 to 50.
Pagepagenumber
Which page, from 1. Use it when 'has_more' was true.At least 1.

Outputs

countnumber
How many were returned
has_moretrue/false
True when there may be another page
pagenumber
The page returned
repositorieslist
The repositories
Example output
{
  "count": 1,
  "has_more": false,
  "page": 1,
  "repositories": [
    {
      "archived": false,
      "clone_url": "https://gitea.example.com/acme/website.git",
      "created_at": "2026-01-05T10:00:00Z",
      "default_branch": "main",
      "description": "Our website",
      "fork": false,
      "forks": 1,
      "full_name": "acme/website",
      "html_url": "https://gitea.example.com/acme/website",
      "name": "website",
      "open_issues": 3,
      "open_pull_requests": 1,
      "owner": "acme",
      "private": false,
      "stars": 4,
      "updated_at": "2026-10-20T09:00:00Z"
    }
  ]
}

Merge pull request

Merge a pull request, by a merge commit, a squash, a rebase or a fast-forward.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
Pull request numberpull_numbertextRequired
The pull request's number, such as 42.
Howmethodtext
How to merge. Defaults to a merge commit.One of: merge (Create a merge commit), squash (Squash and merge), rebase (Rebase and merge), rebase-merge (Rebase, then create a merge commit), fast-forward-only (Fast-forward only). Default: merge.
Commit messagemessagetext
The merge or squash commit's message. Leave empty for Gitea's own.
Delete the branchdelete_branch_aftertrue/false
Delete the merged branch afterwards. Off by default.Default: false.

Outputs

assigneeslist
Who it is assigned to
authortext
Who opened it
base_branchtext
The branch it merges into
bodytext
Its description, in Markdown
closed_attext
When it was closed (ISO 8601); empty when open
commentsnumber
How many comments it has
created_attext
When it was opened (ISO 8601)
drafttrue/false
True while marked work in progress
due_datetext
When it is due (ISO 8601); empty when not set
head_branchtext
The branch with the changes
html_urltext
Its page
labelslist
Its labels' names
mergeabletrue/false
True when it can be merged without conflicts
mergedtrue/false
True once merged
merged_attext
When it was merged (ISO 8601); empty when not
merged_bytext
Who merged it
milestonetext
Its milestone's title; empty when none
numbernumber
Its number in the repository
statetext
open or closed
titletext
Its title
updated_attext
When it last changed (ISO 8601)
Example output
{
  "assignees": [
    "sam"
  ],
  "author": "jo",
  "base_branch": "main",
  "body": "The 'Contact sales' link goes nowhere.",
  "closed_at": "",
  "comments": 2,
  "created_at": "2026-10-20T09:00:00Z",
  "draft": false,
  "due_date": "2026-10-31T00:00:00Z",
  "head_branch": "fix-link",
  "html_url": "https://gitea.example.com/acme/website/pulls/43",
  "labels": [
    "bug"
  ],
  "mergeable": true,
  "merged": true,
  "merged_at": "2026-10-22T09:00:00Z",
  "merged_by": "sam",
  "milestone": "October",
  "number": 43,
  "state": "closed",
  "title": "Fix the pricing link",
  "updated_at": "2026-10-21T09:00:00Z"
}

Save file

Create a file, or replace its text, as one commit on a branch or the default one.

Inputs

RepositoryrepositorytextRequired
The repository, as owner/name. Pick one, type it, or paste its address.
File pathpathtextRequired
The file's path in the repository, such as docs/changes.md.
TextcontenttextRequired
The file's whole new text.
Commit messagemessagetext
What changed. Defaults to 'Update' and the file's path.
Branchbranchtext
The branch to commit to. Leave empty for the default branch.

Outputs

commit_shatext
The commit made
contenttext
Its text; empty when it is not text
createdtrue/false
True when the file was new
download_urltext
Its raw download address
html_urltext
Its page
pathtext
The file's path
shatext
The file's SHA, which changes with every edit
sizenumber
Its size in bytes
Example output
{
  "commit_sha": "9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f2a1b0c",
  "content": "Hello there\n",
  "created": false,
  "download_url": "https://gitea.example.com/acme/website/raw/branch/main/docs/README.md",
  "html_url": "https://gitea.example.com/acme/website/src/branch/main/docs/README.md",
  "path": "docs/README.md",
  "sha": "e6f1b6c3d1bf880d606379609238c57fe60016db",
  "size": 12
}

On this page