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
| Action | What it does |
|---|---|
| Add comment | Comment on an issue or pull request. |
| Change issue | Change an issue or pull request: close or reopen it, rename it, or change its description, labels, assignees, milestone or due date. |
| Create branch | Create a branch from another branch, or from the default one. |
| Create issue | Open an issue, with labels, assignees, a milestone and a due date if you like. |
| Create pull request | Open a pull request to merge one branch into another. |
| Create release | Publish a release, creating its tag from a branch if the tag does not exist yet. |
| Create repository | Create a repository for you or one of your organizations, private and with a README by default. |
| Delete branch | Delete a branch. |
| Delete repository | Delete a repository for good, with its issues, pull requests and releases. |
| Get file | Read a file's text from a repository, on a branch or the default one. |
| Get issue | Get one issue or pull request by its number. |
| Get latest release | Get the newest published release that is not a draft or a pre-release. |
| Get pull request | Get one pull request: its branches, and whether it is merged or can be merged. |
| Get repository | Get a repository's details: its default branch and counts of open issues and pull requests. |
| List branches | List a repository's branches with each one's latest commit. |
| List comments | List the comments on an issue or pull request, oldest first. |
| List issues | List a repository's issues, newest first, by state, labels, words or last change. |
| List labels | List the labels a repository's issues and pull requests can carry. |
| List pull requests | List a repository's pull requests by state. |
| List releases | List a repository's releases, newest first. |
| List repositories | List your repositories, or search every repository you can see by words in its name or description. |
| Merge pull request | Merge a pull request, by a merge commit, a squash, a rebase or a fast-forward. |
| Save file | Create 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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- Issue number
issue_numbertextRequired - The issue's or pull request's number, such as 42.
- Comment
bodytextRequired - 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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- Issue number
issue_numbertextRequired - The issue's or pull request's number, such as 42.
- State
statetext - Close or reopen it.One of:
open,closed. - Title
titletext - A new title.
- Description
bodytext - A new description, in Markdown.
- Labels
labelslist - Its labels, replacing the ones it has.
- Assignees
assigneeslist - People to assign, by user name.
- Milestone
milestonetext - The milestone, by its title.
- Due date
due_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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- New branch
branchtextRequired - The new branch's name.
- From
from_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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- Title
titletextRequired - The issue's title.
- Description
bodytext - What it is about, in Markdown.
- Labels
labelslist - Labels to add.
- Assignees
assigneeslist - People to assign, by user name.
- Milestone
milestonetext - The milestone, by its title.
- Due date
due_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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- From branch
headtextRequired - The branch with the changes.
- Into branch
basetextRequired - The branch to merge into, such as main.
- Title
titletextRequired - The pull request's title.
- Description
bodytext - 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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- Tag
tag_nametextRequired - The release's tag, such as v1.2.0.
- From branch
targettext - The branch to tag when the tag is new. Leave empty for the default branch.
- Title
nametext - The release's title. Defaults to the tag.
- Release notes
notestext - What is in it, in Markdown.
- Draft
drafttrue/false - Save it as a draft rather than publishing it. Off by default.Default:
false. - Pre-release
prereleasetrue/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
- Name
nametextRequired - The repository's name: letters, digits, '-', '_' and '.'.
- Description
descriptiontext - A short description.
- Private
privatetrue/false - Only members can see it. On by default.Default:
true. - Organization
organizationtext - Create it in this organization. Leave empty for your own account.
- Add a README
add_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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- Branch
branchtextRequired - 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
- Repository
repositorytextRequired - 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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- File path
pathtextRequired - The file's path in the repository, such as docs/README.md.
- Branch
branchtext - 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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- Issue number
issue_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
- Repository
repositorytextRequired - 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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- Pull request number
pull_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
- Repository
repositorytextRequired - 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
- Repository
repositorytextRequired - 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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- Issue number
issue_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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- State
statetext - Which issues. Defaults to open.One of:
open,closed,all(Open and closed). Default:open. - Labels
labelslist - Only issues with all of these labels.
- Search for
searchtext - Only issues with these words.
- Changed since
sincedate and time - Only issues changed after this moment.
- Page size
limitnumber - How many to return, up to 50. Defaults to 30.From 1 to 50.
- Page
pagenumber - 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
- Repository
repositorytextRequired - 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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- State
statetext - Which pull requests. Defaults to open.One of:
open,closed,all(Open and closed). Default:open. - Order
sorttext - 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 size
limitnumber - How many to return, up to 50. Defaults to 30.From 1 to 50.
- Page
pagenumber - 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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- Page size
limitnumber - How many to return, up to 50. Defaults to 30.From 1 to 50.
- Page
pagenumber - 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 for
searchtext - Words to search for. Leave empty to list your own repositories (needs a token).
- Page size
limitnumber - How many to return, up to 50. Defaults to 30.From 1 to 50.
- Page
pagenumber - 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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- Pull request number
pull_numbertextRequired - The pull request's number, such as 42.
- How
methodtext - 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 message
messagetext - The merge or squash commit's message. Leave empty for Gitea's own.
- Delete the branch
delete_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
- Repository
repositorytextRequired - The repository, as owner/name. Pick one, type it, or paste its address.
- File path
pathtextRequired - The file's path in the repository, such as docs/changes.md.
- Text
contenttextRequired - The file's whole new text.
- Commit message
messagetext - What changed. Defaults to 'Update' and the file's path.
- Branch
branchtext - 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
}