> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Gitea

The Gitea connector lets your AI agent act in each user's Gitea account. Each user connects their own Gitea API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

**Authentication:** API Key
**Categories:** Developer Tools
**Tools:** 60: 35 read, 20 write, 5 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=GITEA)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Gitea connection

   In **AgentKit > Connections**, create a Gitea connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'gitea'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Gitea:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'gitea_issues_search',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "gitea"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Gitea:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="gitea_issues_search",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Gitea credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'gitea_branch_get',
  toolInput: {
    branch: '<branch>',
    owner: '<owner>',
    repo: '<repo>',
  },
  connector: 'gitea',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="gitea_branch_get",
    tool_input={
        "branch": "<branch>",
        "owner": "<owner>",
        "repo": "<repo>",
    },
    connection_name="gitea",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `gitea_branch_get`

Get Branch · Read-only

Get one branch with its latest commit and protection settings. Returns the branch object. Get names from gitea_branches_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `branch` (`string`, required): Name of the branch. Example: main.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.

Example input: `{"branch":"<branch>","owner":"<owner>","repo":"<repo>"}`

### `gitea_branches_list`

List Branches · Read-only

List a repository's branches with their latest commit and protection status. Returns branch objects. Use gitea_branch_get for one branch.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.
- `q` (`string`, optional): Search keyword. Example: hello.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_collaborators_list`

List Collaborators · Read-only

List the users with direct access to a repository. Returns user objects. Use gitea_collaborator_add to give someone access.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_commit_get`

Get Commit · Read-only

Get one commit by SHA with its message, author, parents, files and stats. Returns the commit object. Get SHAs from gitea_commits_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `sha` (`string`, required): SHA of the commit. Example: 3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15.
- `files` (`boolean`, optional): include a list of affected files for every commit (disable for speedup, default 'true'). Example: true.
- `stat` (`boolean`, optional): include diff stats for every commit (disable for speedup, default 'true'). Example: true.
- `verification` (`boolean`, optional): include verification for every commit (disable for speedup, default 'true'). Example: true.

Example input: `{"owner":"<owner>","repo":"<repo>","sha":"<sha>"}`

### `gitea_commits_list`

List Commits · Read-only

List commits on a branch or ref, optionally only those touching a path or in a time range. Returns commit objects with SHA, message, author and stats. Use gitea_commit_get for one commit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `files` (`boolean`, optional): include a list of affected files for every commit (disable for speedup, default 'true'). Example: true.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `not` (`string`, optional): commits that match the given specifier will not be listed. Example: release-1.0.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.
- `path` (`string`, optional): Only return commits that touch this file or directory path. Example: docs/README.md.
- `sha` (`string`, optional): Blob SHA of the file being replaced or deleted. Get it from gitea_contents_get. Example: 3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15.
- `since` (`string`, optional): Only return items updated after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
- `stat` (`boolean`, optional): include diff stats for every commit (disable for speedup, default 'true'). Example: true.
- `until` (`string`, optional): Only commits before this date will be returned (ISO 8601 format). Example: 2026-01-15T09:30:00Z.
- `verification` (`boolean`, optional): include verification for every commit (disable for speedup, default 'true'). Example: true.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_contents_get`

Get File or Directory · Read-only

Get a file's metadata and base64 content, or a directory's entries, at a path and ref. Returns the content object including the blob sha needed by gitea_file_update and gitea_file_delete.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `filepath` (`string`, required): Path of the file inside the repository, for example README.md or docs/guide.md for a nested file. Example: README.md.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `ref` (`string`, optional): Branch, tag or commit to read from. Defaults to the repository's default branch. Example: main.

Example input: `{"filepath":"<filepath>","owner":"<owner>","repo":"<repo>"}`

### `gitea_issue_comments_list`

List Issue Comments · Read-only

List the comments on an issue or pull request. Returns comment objects with author, body and time. Get issue numbers from gitea_issues_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `index` (`integer`, required): Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `before` (`string`, optional): Only return items updated before this time (ISO 8601). Example: 2026-02-01T00:00:00Z.
- `since` (`string`, optional): Only return items updated after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.

Example input: `{"index":12,"owner":"<owner>","repo":"<repo>"}`

### `gitea_issue_get`

Get Issue · Read-only

Get one issue (or pull request) by number with its body, state, labels, assignees and milestone. Returns the issue object. Get issue numbers from gitea_issues_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `index` (`integer`, required): Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.

Example input: `{"index":12,"owner":"<owner>","repo":"<repo>"}`

### `gitea_issues_list`

List Issues · Read-only

List a repository's issues or pull requests, filtered by state, labels, milestone, author, assignee or keyword. Returns issue objects. Use gitea_issues_search to search across repositories and gitea_issue_get for one issue.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `assigned_by` (`string`, optional): Only show items for which the given user is assigned. Example: jdoe.
- `before` (`string`, optional): Only return items updated before this time (ISO 8601). Example: 2026-02-01T00:00:00Z.
- `created_by` (`string`, optional): Only show items which were created by the given user. Example: jdoe.
- `labels` (`string`, optional): Comma-separated label names to filter by. Example: bug,ui.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `mentioned_by` (`string`, optional): Only show items in which the given user was mentioned. Example: jdoe.
- `milestones` (`string`, optional): comma separated list of milestone names or ids. It uses names and fall back to ids. Fetch only issues that have any of this milestones. Non existent milestones are discarded. Example: v1.2.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.
- `q` (`string`, optional): Search keyword. Example: hello.
- `since` (`string`, optional): Only return items updated after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
- `state` (`string`, optional): State to filter by or set: open or closed (all is allowed on list tools). Example: open. One of: `closed`, `open`, `all`.
- `type` (`string`, optional): Only return issues or pulls. Example: issues. One of: `issues`, `pulls`.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_issues_search`

Search Issues · Read-only

Search issues and pull requests across every repository the token can see, filtered by state, labels, keyword, type, owner or involvement. Returns issue objects with their repository. Use gitea_issues_list inside one repository.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `assigned` (`boolean`, optional): Filter issues or pulls assigned to the authenticated user. Example: false.
- `before` (`string`, optional): Only return items updated before this time (ISO 8601). Example: 2026-02-01T00:00:00Z.
- `created` (`boolean`, optional): Filter issues or pulls created by the authenticated user. Example: false.
- `created_by` (`string`, optional): Only show items which were created by the given user. Example: jdoe.
- `labels` (`string`, optional): Comma-separated label names to filter by. Example: bug,ui.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `mentioned` (`boolean`, optional): Filter issues or pulls mentioning the authenticated user. Example: false.
- `milestones` (`string`, optional): Comma-separated list of milestone names. Fetch only issues that have any of these milestones. Non existent milestones are discarded. Example: v1.2.
- `owner` (`string`, optional): Owner of the repository: a user name or organization name. Example: octo-org.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.
- `q` (`string`, optional): Search keyword. Example: hello.
- `review_requested` (`boolean`, optional): Filter pull requests where the authenticated user's review was requested. Example: false.
- `reviewed` (`boolean`, optional): Filter pull requests reviewed by the authenticated user. Example: false.
- `since` (`string`, optional): Only return items updated after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
- `state` (`string`, optional): State to filter by or set: open or closed (all is allowed on list tools). Example: open. One of: `open`, `closed`, `all`.
- `team` (`string`, optional): Filter by team (requires organization owner parameter). Example: backend.
- `type` (`string`, optional): Only return issues or pulls. Example: issues. One of: `issues`, `pulls`.

Example input: `{}`

### `gitea_labels_list`

List Labels · Read-only

List a repository's labels. Returns label objects with ID, name, color and description. Use the IDs with gitea_issue_create and gitea_issue_labels_add.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_milestones_list`

List Milestones · Read-only

List a repository's milestones, optionally by state or name. Returns milestone objects with progress counts. Use the IDs with gitea_issue_create.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `name` (`string`, optional): Name. Example: hello-world.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.
- `state` (`string`, optional): State to filter by or set: open or closed (all is allowed on list tools). Example: open.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_notifications_list`

List Notifications · Read-only

List the token user's notification threads (issues, pull requests, commits, releases), unread by default. Returns notification threads with their subject and repository.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `all` (`boolean`, optional): If true, show notifications marked as read. Default value is false. Example: true.
- `before` (`string`, optional): Only return items updated before this time (ISO 8601). Example: 2026-02-01T00:00:00Z.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.
- `since` (`string`, optional): Only return items updated after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
- `status_types` (`array`, optional): Show notifications with the provided status types. Options are: unread, read and/or pinned. Defaults to unread & pinned. Example: ["unread"]
- `subject_type` (`array`, optional): filter notifications by subject type. Example: ["issues"]

Example input: `{}`

### `gitea_org_get`

Get Organization · Read-only

Get one organization with its description, website, visibility and settings. Returns the organization object. Get names from gitea_orgs_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org` (`string`, required): Name of the organization. Example: octo-org.

Example input: `{"org":"<org>"}`

### `gitea_org_members_list`

List Organization Members · Read-only

List an organization's members (public members only unless the token's user is a member). Returns user objects. Get organization names from gitea_orgs_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org` (`string`, required): Name of the organization. Example: octo-org.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.

Example input: `{"org":"<org>"}`

### `gitea_org_repos_list`

List Organization Repositories · Read-only

List an organization's repositories. Returns repository objects. Get organization names from gitea_orgs_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org` (`string`, required): Name of the organization. Example: octo-org.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.

Example input: `{"org":"<org>"}`

### `gitea_org_teams_list`

List Organization Teams · Read-only

List an organization's teams with their permissions. Returns team objects. Get organization names from gitea_orgs_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org` (`string`, required): Name of the organization. Example: octo-org.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.

Example input: `{"org":"<org>"}`

### `gitea_orgs_list`

List Organizations · Read-only

List the organizations on the Gitea instance that the token can see. Returns organization objects. Use gitea_user_orgs_list for the token user's own organizations.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.

Example input: `{}`

### `gitea_pull_files_list`

List Pull Request Files · Read-only

List the files a pull request changes, with additions, deletions and status. Returns changed file objects. Get pull request numbers from gitea_pulls_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `index` (`integer`, required): Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.
- `skip_to` (`string`, optional): Skip to this file path in the list of changed files. Example: src/app.go.
- `whitespace` (`string`, optional): How whitespace changes are shown: ignore-all, ignore-change, ignore-eol or show-all. Example: ignore-all. One of: `ignore-all`, `ignore-change`, `ignore-eol`, `show-all`.

Example input: `{"index":12,"owner":"<owner>","repo":"<repo>"}`

### `gitea_pull_get`

Get Pull Request · Read-only

Get one pull request by number with its head and base, mergeable flag, state and review requests. Returns the pull request object. Get pull request numbers from gitea_pulls_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `index` (`integer`, required): Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.

Example input: `{"index":12,"owner":"<owner>","repo":"<repo>"}`

### `gitea_pull_reviews_list`

List Pull Request Reviews · Read-only

List the reviews on a pull request with state (approved, request changes, comment) and body. Returns review objects. Get pull request numbers from gitea_pulls_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `index` (`integer`, required): Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.

Example input: `{"index":12,"owner":"<owner>","repo":"<repo>"}`

### `gitea_pulls_list`

List Pull Requests · Read-only

List a repository's pull requests, filtered by state, base branch, labels, milestone or poster, with sorting. Returns pull request objects. Use gitea_pull_get for one pull request.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `base_branch` (`string`, optional): Filter by target base branch of the pull request. Example: main.
- `labels` (`array`, optional): Only return pull requests with these label IDs. Example: [1, 2]
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `milestone` (`integer`, optional): ID of the milestone. Get IDs from gitea_milestones_list. Example: 3.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.
- `poster` (`string`, optional): Only return pull requests opened by this user. Example: jdoe.
- `sort` (`string`, optional): Sort order of the results. Example: recentupdate. One of: `oldest`, `recentupdate`, `recentclose`, `leastupdate`, `mostcomment`, `leastcomment`, `priority`.
- `state` (`string`, optional): State to filter by or set: open or closed (all is allowed on list tools). Example: open. One of: `open`, `closed`, `all`.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_release_get`

Get Release · Read-only

Get one release by ID. Returns the release with its notes and assets. Get IDs from gitea_releases_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `release_id` (`integer`, required): ID of the release. Example: 345.
- `repo` (`string`, required): Name of the repository. Example: hello-world.

Example input: `{"owner":"<owner>","release_id":345,"repo":"<repo>"}`

### `gitea_release_latest_get`

Get Latest Release · Read-only

Get the most recent published release that is not a draft or pre-release. Returns the release object. Use gitea_releases_list for all releases.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_releases_list`

List Releases · Read-only

List a repository's releases, optionally drafts or pre-releases only. Returns release objects with notes and assets. Use gitea_release_latest_get for the newest release.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `draft` (`boolean`, optional): filter (exclude / include) drafts, if you don't have repo write access none will show. Example: true.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.
- `pre_release` (`boolean`, optional): filter (exclude / include) pre-releases. Example: true.
- `tag_filter` (`string`, optional): filter releases by tag. supports "*" as a wildcard (for example: v1*, *beta, *rc*). Example: v1.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_repo_forks_list`

List Forks · Read-only

List the forks of a repository. Returns repository objects. Get repositories from gitea_repos_search or gitea_user_repos_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_repo_get`

Get Repository · Read-only

Get one repository with its description, default branch, visibility, counts and clone URLs. Get repositories from gitea_repos_search or gitea_user_repos_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_repos_search`

Search Repositories · Read-only

Search the repositories visible to the token by keyword, owner, topic or type, with sorting. Returns matching repositories. Use gitea_repo_get for one repository.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `archived` (`boolean`, optional): true archives the repository (read-only); false unarchives it. Example: true.
- `exclusive` (`boolean`, optional): true makes the label exclusive within its scope (labels named scope/name), so an issue can only have one of them. Example: false.
- `include_desc` (`boolean`, optional): include search of keyword within repository description. Example: true.
- `is_private` (`boolean`, optional): show only pubic, private or all repositories (defaults to all). Example: true.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `mode` (`string`, optional): type of repository to search for. Supported values are "fork", "source", "mirror" and "collaborative". Example: source.
- `order` (`string`, optional): sort order, either "asc" (ascending) or "desc" (descending). Default is "asc", ignored if "sort" is not specified. Example: desc.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.
- `priority_owner_id` (`integer`, optional): repo owner to prioritize in the results. Example: 7.
- `private` (`boolean`, optional): true makes the repository private. Example: false.
- `q` (`string`, optional): Search keyword. Example: hello.
- `sort` (`string`, optional): Sort order of the results. Example: updated.
- `team_id` (`integer`, optional): search only for repos that belong to the given team id. Example: 4.
- `template` (`boolean`, optional): true marks the repository as a template. Example: false.
- `topic` (`boolean`, optional): Limit search to repositories with keyword as topic. Example: false.

Example input: `{}`

### `gitea_tags_list`

List Tags · Read-only

List a repository's tags with their commit. Returns tag objects. Use gitea_releases_list for releases.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_user_get`

Get Current User · Read-only

Get the user the access token belongs to. Returns the user's login, name, email and admin flag. Use gitea_user_get_by_name for another user.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `gitea_user_get_by_name`

Get User · Read-only

Get a user by login. Returns the user's profile. Use gitea_users_search to find logins.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `username` (`string`, required): User name (login) of the user. Example: jdoe.

Example input: `{"username":"<username>"}`

### `gitea_user_orgs_list`

List My Organizations · Read-only

List the organizations the token's user belongs to. Returns organization objects. Use gitea_orgs_list for every organization on the instance.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.

Example input: `{}`

### `gitea_user_repos_list`

List My Repositories · Read-only

List the repositories the token's user owns. Returns repository objects with full names, URLs and settings. Use gitea_repos_search to search all visible repositories.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.

Example input: `{}`

### `gitea_users_search`

Search Users · Read-only

Search users by keyword in their login, name or email. Returns matching user objects. Use gitea_user_get_by_name when you know the login.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Number of results per page. Example: 25.
- `page` (`integer`, optional): Page number of results, starting at 1. Example: 1.
- `q` (`string`, optional): Search keyword. Example: hello.

Example input: `{}`

### `gitea_version_get`

Get Gitea Version · Read-only

Get the version of the Gitea server. Returns the version string. Use it to check what the instance supports or to test the connection.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `gitea_branch_create`

Create Branch · Write

Create a branch from an existing branch, tag or commit (old_ref_name). Returns the new branch. Get names from gitea_branches_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `new_branch_name` (`string`, required): Name of the branch to create. Example: feature/login-fix.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `old_ref_name` (`string`, optional): Branch, tag or commit SHA to create the branch from. Defaults to the default branch. Example: main.

Example input: `{"new_branch_name":"<new_branch_name>","owner":"<owner>","repo":"<repo>"}`

### `gitea_collaborator_add`

Add Collaborator · Write

Give a user direct access to a repository with read, write or admin permission. Returns an empty response. Find logins with gitea_users_search.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collaborator` (`string`, required): Login of the user to add. Example: jdoe.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `permission` (`string`, optional): Permission level to grant the collaborator. Example: write. One of: `read`, `write`, `admin`.

Example input: `{"collaborator":"<collaborator>","owner":"<owner>","repo":"<repo>"}`

### `gitea_file_create`

Create File · Write

Create a new file with base64 content and commit it to a branch (or a new branch). Returns the file and commit. Use gitea_file_update to change an existing file.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `content` (`string`, required): New file content, base64-encoded. Example: IyBIZWxsbyBXb3JsZAo=.
- `filepath` (`string`, required): Path of the file inside the repository, for example README.md or docs/guide.md for a nested file. Example: README.md.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `author` (`object`, optional): Commit author as an object with name and email. Defaults to the token's user. Example: {"name": "Jane Doe", "email": "jane@example.com"}
- `branch` (`string`, optional): Name of the branch. Example: main.
- `committer` (`object`, optional): Committer as an object with name and email. Defaults to the token's user. Example: {"name": "Jane Doe", "email": "jane@example.com"}
- `dates` (`object`, optional): Author and committer dates as an object with author and committer timestamps (ISO 8601). Example: {"author": "2026-01-15T09:30:00Z", "committer": "2026-01-15T09:30:00Z"}
- `force_push` (`boolean`, optional): force_push (optional) will do a force-push if the new branch already exists. Example: true.
- `message` (`string`, optional): Commit message. Gitea writes a default one when empty. Example: Update README.
- `new_branch` (`string`, optional): Create this new branch from branch and commit to it. Leave empty to commit to branch. Example: docs-update.
- `signoff` (`boolean`, optional): Add a Signed-off-by trailer by the committer at the end of the commit log message. Example: true.

Example input: `{"content":"<content>","filepath":"<filepath>","owner":"<owner>","repo":"<repo>"}`

### `gitea_file_update`

Update File · Write

Replace an existing file's content (base64) and commit it, optionally moving it from from_path. Returns the file and commit. Needs the current blob sha from gitea_contents_get.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `content` (`string`, required): New file content, base64-encoded. Example: IyBIZWxsbyBXb3JsZAo=.
- `filepath` (`string`, required): Path of the file inside the repository, for example README.md or docs/guide.md for a nested file. Example: README.md.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `author` (`object`, optional): Commit author as an object with name and email. Defaults to the token's user. Example: {"name": "Jane Doe", "email": "jane@example.com"}
- `branch` (`string`, optional): Name of the branch. Example: main.
- `committer` (`object`, optional): Committer as an object with name and email. Defaults to the token's user. Example: {"name": "Jane Doe", "email": "jane@example.com"}
- `dates` (`object`, optional): Author and committer dates as an object with author and committer timestamps (ISO 8601). Example: {"author": "2026-01-15T09:30:00Z", "committer": "2026-01-15T09:30:00Z"}
- `force_push` (`boolean`, optional): force_push (optional) will do a force-push if the new branch already exists. Example: true.
- `from_path` (`string`, optional): from_path (optional) is the path of the original file which will be moved/renamed to the path in the URL. Example: docs/OLD.md.
- `message` (`string`, optional): Commit message. Gitea writes a default one when empty. Example: Update README.
- `new_branch` (`string`, optional): Create this new branch from branch and commit to it. Leave empty to commit to branch. Example: docs-update.
- `sha` (`string`, optional): Blob SHA of the file being replaced or deleted. Get it from gitea_contents_get. Example: 3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15.
- `signoff` (`boolean`, optional): Add a Signed-off-by trailer by the committer at the end of the commit log message. Example: true.

Example input: `{"content":"<content>","filepath":"<filepath>","owner":"<owner>","repo":"<repo>"}`

### `gitea_issue_comment_create`

Comment on Issue · Write

Add a comment to an issue or pull request. Returns the new comment. Get issue numbers from gitea_issues_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `body` (`string`, required): Text body (Markdown). Example: Fixes the login redirect loop.
- `index` (`integer`, required): Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.

Example input: `{"body":"<body>","index":12,"owner":"<owner>","repo":"<repo>"}`

### `gitea_issue_comment_update`

Update Issue Comment · Write

Edit the body of an issue or pull request comment. Returns the updated comment. Get comment IDs from gitea_issue_comments_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `body` (`string`, required): Text body (Markdown). Example: Fixes the login redirect loop.
- `comment_id` (`integer`, required): ID of the comment. Example: 345.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.

Example input: `{"body":"<body>","comment_id":345,"owner":"<owner>","repo":"<repo>"}`

### `gitea_issue_create`

Create Issue · Write

Open an issue with a title, body, assignees, labels, milestone and due date. Returns the new issue with its number. Get label IDs from gitea_labels_list and milestone IDs from gitea_milestones_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `title` (`string`, required): Title of the issue, pull request or milestone. Example: Login redirect loops on Safari.
- `assignee` (`string`, optional): User name to assign (deprecated in favour of assignees). Example: jdoe.
- `assignees` (`array`, optional): User names to assign. Example: ["jdoe"]
- `body` (`string`, optional): Text body (Markdown). Example: Fixes the login redirect loop.
- `closed` (`boolean`, optional): true creates the issue already closed. Example: true.
- `due_date` (`string`, optional): Due date (ISO 8601), for example 2026-03-31T00:00:00Z. Example: 2026-01-15T09:30:00Z.
- `labels` (`array`, optional): IDs of the labels to put on the issue. Example: [1, 2]
- `milestone` (`integer`, optional): ID of the milestone. Get IDs from gitea_milestones_list. Example: 3.
- `projects` (`array`, optional): IDs of Gitea projects to add the issue to. Example: [1, 2]
- `ref` (`string`, optional): Branch, tag or commit to read from. Defaults to the repository's default branch. Example: main.

Example input: `{"owner":"<owner>","repo":"<repo>","title":"<title>"}`

### `gitea_issue_labels_add`

Add Labels to Issue · Write

Add labels to an issue or pull request, keeping the existing ones. Returns the issue's labels. Get label IDs or names from gitea_labels_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `index` (`integer`, required): Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `labels` (`array`, optional): Labels to add, as label IDs or names. Example: ["bug", 3]

Example input: `{"index":12,"owner":"<owner>","repo":"<repo>"}`

### `gitea_issue_update`

Update Issue · Write

Edit an issue: title, body, assignees, milestone, due date, or close and reopen it with state. Returns the updated issue. Get issue numbers from gitea_issues_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `index` (`integer`, required): Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `assignee` (`string`, optional): User name to assign (deprecated in favour of assignees). Example: jdoe.
- `assignees` (`array`, optional): User names to assign. Example: ["jdoe"]
- `body` (`string`, optional): Text body (Markdown). Example: Fixes the login redirect loop.
- `content_version` (`integer`, optional): The current version of the issue content to detect conflicts during editing. Example: 10.
- `due_date` (`string`, optional): Due date (ISO 8601), for example 2026-03-31T00:00:00Z. Example: 2026-01-15T09:30:00Z.
- `milestone` (`integer`, optional): ID of the milestone. Get IDs from gitea_milestones_list. Example: 3.
- `projects` (`array`, optional): IDs of Gitea projects to add the issue to. Example: [1, 2]
- `ref` (`string`, optional): Branch, tag or commit to read from. Defaults to the repository's default branch. Example: main.
- `state` (`string`, optional): State to filter by or set: open or closed (all is allowed on list tools). Example: open.
- `title` (`string`, optional): Title of the issue, pull request or milestone. Example: Login redirect loops on Safari.
- `unset_due_date` (`boolean`, optional): true removes the due date. Example: true.

Example input: `{"index":12,"owner":"<owner>","repo":"<repo>"}`

### `gitea_label_create`

Create Label · Write

Create a label in a repository. Returns the new label. Use gitea_labels_list to see existing labels.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `color` (`string`, required): Label color as a hex code, for example #ee0701. Example: #ee0701.
- `name` (`string`, required): Name. Example: needs-triage.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `description` (`string`, optional): Short description. Example: Issue still needs triage.
- `exclusive` (`boolean`, optional): true makes the label exclusive within its scope (labels named scope/name), so an issue can only have one of them. Example: false.
- `is_archived` (`boolean`, optional): true creates the label archived. Example: false.

Example input: `{"color":"<color>","name":"<name>","owner":"<owner>","repo":"<repo>"}`

### `gitea_milestone_create`

Create Milestone · Write

Create a milestone with a title, description and due date. Returns the new milestone. Use gitea_milestones_list to see existing ones.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `description` (`string`, optional): Short description. Example: Login and SSO fixes.
- `due_on` (`string`, optional): Deadline is the due date for the milestone. Example: 2026-03-31T00:00:00Z.
- `state` (`string`, optional): State to filter by or set: open or closed (all is allowed on list tools). Example: open. One of: `open`, `closed`.
- `title` (`string`, optional): Title of the issue, pull request or milestone. Example: v1.2.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_org_repo_create`

Create Organization Repository · Write

Create a repository in an organization the token's user can create repositories in. Returns the new repository. Get organization names from gitea_user_orgs_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name. Example: hello-world.
- `org` (`string`, required): Name of the organization. Example: octo-org.
- `auto_init` (`boolean`, optional): Whether the repository should be auto-initialized? Example: true.
- `default_branch` (`string`, optional): DefaultBranch of the repository (used when initializes and in template). Example: main.
- `description` (`string`, optional): Short description. Example: Internal tools for the platform team.
- `gitignores` (`string`, optional): Comma-separated .gitignore templates to add, for example Go,Node. Example: Go.
- `issue_labels` (`string`, optional): Label set to create in the new repository, for example Default. Example: Default.
- `license` (`string`, optional): License template to add, for example MIT. Example: MIT.
- `object_format_name` (`string`, optional): ObjectFormatName of the underlying git repository, empty string for default (sha1). Example: sha1. One of: `sha1`, `sha256`.
- `private` (`boolean`, optional): true makes the repository private. Example: false.
- `readme` (`string`, optional): README template to add, for example Default (used with auto_init). Example: Default.
- `template` (`boolean`, optional): true marks the repository as a template. Example: false.
- `trust_model` (`string`, optional): Commit signature trust model: default, collaborator, committer or collaboratorcommitter. Example: default. One of: `default`, `collaborator`, `committer`, `collaboratorcommitter`.

Example input: `{"name":"<name>","org":"<org>"}`

### `gitea_pull_create`

Create Pull Request · Write

Open a pull request from a head branch into a base branch, with title, body, assignees, labels, milestone and reviewers. Returns the new pull request. Get branches from gitea_branches_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `allow_maintainer_edit` (`boolean`, optional): true lets maintainers push to the pull request branch. Example: true.
- `assignee` (`string`, optional): User name to assign (deprecated in favour of assignees). Example: jdoe.
- `assignees` (`array`, optional): User names to assign. Example: ["jdoe"]
- `base` (`string`, optional): Branch the pull request merges into, for example main. Example: main.
- `body` (`string`, optional): Text body (Markdown). Example: Fixes the login redirect loop.
- `due_date` (`string`, optional): Due date (ISO 8601), for example 2026-03-31T00:00:00Z. Example: 2026-01-15T09:30:00Z.
- `head` (`string`, optional): Branch with the changes, for example feature/login-fix (user:branch for a fork). Example: feature/login-fix.
- `labels` (`array`, optional): Comma-separated label names to filter by. Example: [1, 2]
- `milestone` (`integer`, optional): ID of the milestone. Get IDs from gitea_milestones_list. Example: 3.
- `reviewers` (`array`, optional): User names to request reviews from. Example: ["jdoe"]
- `team_reviewers` (`array`, optional): Team names to request reviews from. Example: ["backend"]
- `title` (`string`, optional): Title of the issue, pull request or milestone. Example: Login redirect loops on Safari.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_pull_merge`

Merge Pull Request · Write

Merge a pull request with a merge style (merge, rebase, squash and more), optionally deleting the branch afterwards or merging when checks succeed. Returns an empty response on success. Check gitea_pull_get for mergeable first.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `do` (`string`, required): Do. Example: merge. One of: `merge`, `rebase`, `rebase-merge`, `squash`, `fast-forward-only`, `manually-merged`.
- `index` (`integer`, required): Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `delete_branch_after_merge` (`boolean`, optional): true deletes the head branch after the merge. Example: true.
- `force_merge` (`boolean`, optional): true merges even if required checks have not passed (needs admin rights). Example: true.
- `head_commit_id` (`string`, optional): Expected head commit SHA; the merge fails if the branch moved since. Example: 3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15.
- `merge_commit_id` (`string`, optional): Merge Commit ID. Example: a1b2c3d4.
- `merge_message_field` (`string`, optional): Message body of the merge commit. Example: Merge login fix.
- `merge_title_field` (`string`, optional): Title of the merge commit. Example: Merge pull request #12.
- `merge_when_checks_succeed` (`boolean`, optional): true schedules the merge to happen automatically once checks pass. Example: true.

Example input: `{"do":"merge","index":12,"owner":"<owner>","repo":"<repo>"}`

### `gitea_pull_review_create`

Review Pull Request · Write

Submit a review on a pull request: approve, request changes or comment, with an optional body and inline comments. Returns the review. Get pull request numbers from gitea_pulls_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `index` (`integer`, required): Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `body` (`string`, optional): Text body (Markdown). Example: Fixes the login redirect loop.
- `comments` (`array`, optional): Inline review comments, each with a file path, a line position (new_position or old_position) and a body. Example: [{"path": "src/app.go", "new_position": 12, "body": "Please handle the error here."}]
- `commit_id` (`string`, optional): SHA of the commit the review applies to. Defaults to the latest commit. Example: 3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15.
- `event` (`string`, optional): Review result: APPROVED, REQUEST_CHANGES or COMMENT. Example: COMMENT. One of: `APPROVED`, `PENDING`, `COMMENT`, `REQUEST_CHANGES`, `REQUEST_REVIEW`.

Example input: `{"index":12,"owner":"<owner>","repo":"<repo>"}`

### `gitea_pull_update`

Update Pull Request · Write

Edit a pull request: title, body, base branch, assignees, labels, milestone, due date, or close and reopen it with state. Returns the updated pull request. Get pull request numbers from gitea_pulls_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `index` (`integer`, required): Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `allow_maintainer_edit` (`boolean`, optional): true lets maintainers push to the pull request branch. Example: true.
- `assignee` (`string`, optional): User name to assign (deprecated in favour of assignees). Example: jdoe.
- `assignees` (`array`, optional): User names to assign. Example: ["jdoe"]
- `base` (`string`, optional): Branch the pull request merges into, for example main. Example: main.
- `body` (`string`, optional): Text body (Markdown). Example: Fixes the login redirect loop.
- `content_version` (`integer`, optional): The current version of the pull request content to detect conflicts during editing. Example: 10.
- `due_date` (`string`, optional): Due date (ISO 8601), for example 2026-03-31T00:00:00Z. Example: 2026-01-15T09:30:00Z.
- `labels` (`array`, optional): Comma-separated label names to filter by. Example: [1, 2]
- `milestone` (`integer`, optional): ID of the milestone. Get IDs from gitea_milestones_list. Example: 3.
- `state` (`string`, optional): State to filter by or set: open or closed (all is allowed on list tools). Example: open.
- `title` (`string`, optional): Title of the issue, pull request or milestone. Example: Login redirect loops on Safari.
- `unset_due_date` (`boolean`, optional): true removes the due date. Example: true.

Example input: `{"index":12,"owner":"<owner>","repo":"<repo>"}`

### `gitea_release_create`

Create Release · Write

Create a release for a tag (creating the tag from target_commitish if needed), as a draft or pre-release if wanted. Returns the new release. Get tags from gitea_tags_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `tag_name` (`string`, required): Tag the release is for, for example v1.2.0. Created if it does not exist. Example: v1.2.0.
- `body` (`string`, optional): Text body (Markdown). Example: Fixes the login redirect loop.
- `draft` (`boolean`, optional): Whether to create the release as a draft. Example: true.
- `name` (`string`, optional): Name. Example: hello-world.
- `prerelease` (`boolean`, optional): Whether to mark the release as a prerelease. Example: true.
- `tag_message` (`string`, optional): Message of the annotated tag created for the release. Example: Release v1.2.0.
- `target_commitish` (`string`, optional): Branch or commit to create the tag from when the tag does not exist yet. Example: main.

Example input: `{"owner":"<owner>","repo":"<repo>","tag_name":"<tag_name>"}`

### `gitea_repo_create`

Create Repository · Write

Create a repository owned by the token's user, optionally initialised with a README, license and .gitignore. Returns the new repository. Use gitea_org_repo_create for an organization.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name. Example: hello-world.
- `auto_init` (`boolean`, optional): Whether the repository should be auto-initialized? Example: true.
- `default_branch` (`string`, optional): DefaultBranch of the repository (used when initializes and in template). Example: main.
- `description` (`string`, optional): Short description. Example: Internal tools for the platform team.
- `gitignores` (`string`, optional): Comma-separated .gitignore templates to add, for example Go,Node. Example: Go.
- `issue_labels` (`string`, optional): Label set to create in the new repository, for example Default. Example: Default.
- `license` (`string`, optional): License template to add, for example MIT. Example: MIT.
- `object_format_name` (`string`, optional): ObjectFormatName of the underlying git repository, empty string for default (sha1). Example: sha1. One of: `sha1`, `sha256`.
- `private` (`boolean`, optional): true makes the repository private. Example: false.
- `readme` (`string`, optional): README template to add, for example Default (used with auto_init). Example: Default.
- `template` (`boolean`, optional): true marks the repository as a template. Example: false.
- `trust_model` (`string`, optional): Commit signature trust model: default, collaborator, committer or collaboratorcommitter. Example: default. One of: `default`, `collaborator`, `committer`, `collaboratorcommitter`.

Example input: `{"name":"<name>"}`

### `gitea_repo_fork`

Fork Repository · Write

Fork a repository into the token's user account or an organization. Returns the new fork (Gitea may finish copying in the background). Get repositories from gitea_repos_search or gitea_user_repos_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `name` (`string`, optional): Name. Example: hello-world.
- `organization` (`string`, optional): organization name, if forking into an organization. Example: octo-org.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_repo_update`

Update Repository · Write

Update a repository's settings: name, description, website, visibility, default branch, archived flag, enabled units and merge options. Returns the updated repository. Get repositories from gitea_repos_search or gitea_user_repos_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `allow_merge_commits` (`boolean`, optional): either true to allow merging pull requests with a merge commit, or false to prevent merging pull requests with merge commits. Example: true.
- `allow_rebase` (`boolean`, optional): either true to allow rebase-merging pull requests, or false to prevent rebase-merging. Example: true.
- `allow_squash_merge` (`boolean`, optional): either true to allow squash-merging pull requests, or false to prevent squash-merging. Example: true.
- `archived` (`boolean`, optional): true archives the repository (read-only); false unarchives it. Example: true.
- `default_branch` (`string`, optional): sets the default branch for this repository. Example: main.
- `default_delete_branch_after_merge` (`boolean`, optional): set to true to delete pr branch after merge by default. Example: true.
- `default_merge_style` (`string`, optional): set to a merge style to be used by this repository: "merge", "rebase", "rebase-merge", "squash", or "fast-forward-only". Example: merge.
- `description` (`string`, optional): Short description. Example: Internal tools for the platform team.
- `has_actions` (`boolean`, optional): either true to enable actions unit, or false to disable them. Example: true.
- `has_issues` (`boolean`, optional): either true to enable issues for this repository or false to disable them. Example: true.
- `has_projects` (`boolean`, optional): either true to enable project unit, or false to disable them. Example: true.
- `has_pull_requests` (`boolean`, optional): either true to allow pull requests, or false to prevent pull request. Example: true.
- `has_releases` (`boolean`, optional): either true to enable releases unit, or false to disable them. Example: true.
- `has_wiki` (`boolean`, optional): either true to enable the wiki for this repository or false to disable it. Example: true.
- `name` (`string`, optional): Name. Example: hello-world.
- `private` (`boolean`, optional): true makes the repository private. Example: false.
- `template` (`boolean`, optional): true marks the repository as a template. Example: false.
- `website` (`string`, optional): a URL with more information about the repository. Example: https://example.com.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

### `gitea_branch_delete`

Delete Branch · Destructive

Delete a branch (not the default or a protected branch). Returns an empty response. Get names from gitea_branches_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `branch` (`string`, required): Name of the branch. Example: main.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.

Example input: `{"branch":"<branch>","owner":"<owner>","repo":"<repo>"}`

### `gitea_file_delete`

Delete File · Destructive

Delete a file and commit the change to a branch. Returns the commit. Needs the current blob sha from gitea_contents_get.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `filepath` (`string`, required): Path of the file inside the repository, for example README.md or docs/guide.md for a nested file. Example: README.md.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.
- `sha` (`string`, required): Blob SHA of the file being replaced or deleted. Get it from gitea_contents_get. Example: 3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15.
- `author` (`object`, optional): Commit author as an object with name and email. Defaults to the token's user. Example: {"name": "Jane Doe", "email": "jane@example.com"}
- `branch` (`string`, optional): Name of the branch. Example: main.
- `committer` (`object`, optional): Committer as an object with name and email. Defaults to the token's user. Example: {"name": "Jane Doe", "email": "jane@example.com"}
- `dates` (`object`, optional): Author and committer dates as an object with author and committer timestamps (ISO 8601). Example: {"author": "2026-01-15T09:30:00Z", "committer": "2026-01-15T09:30:00Z"}
- `force_push` (`boolean`, optional): force_push (optional) will do a force-push if the new branch already exists. Example: true.
- `message` (`string`, optional): Commit message. Gitea writes a default one when empty. Example: Update README.
- `new_branch` (`string`, optional): Create this new branch from branch and commit to it. Leave empty to commit to branch. Example: docs-update.
- `signoff` (`boolean`, optional): Add a Signed-off-by trailer by the committer at the end of the commit log message. Example: true.

Example input: `{"filepath":"<filepath>","owner":"<owner>","repo":"<repo>","sha":"<sha>"}`

### `gitea_issue_comment_delete`

Delete Issue Comment · Destructive

Delete an issue or pull request comment. Returns an empty response. Get comment IDs from gitea_issue_comments_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `comment_id` (`integer`, required): ID of the comment. Example: 345.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.

Example input: `{"comment_id":345,"owner":"<owner>","repo":"<repo>"}`

### `gitea_issue_label_remove`

Remove Label from Issue · Destructive

Remove one label from an issue or pull request. Returns an empty response. Get label IDs from gitea_labels_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `index` (`integer`, required): Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
- `label_id` (`integer`, required): ID of the label to remove. Example: 3.
- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.

Example input: `{"index":12,"label_id":3,"owner":"<owner>","repo":"<repo>"}`

### `gitea_repo_delete`

Delete Repository · Destructive

Permanently delete a repository with all its issues, pull requests and history. Returns an empty response. Get repositories from gitea_repos_search or gitea_user_repos_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Owner of the repository: a user name or organization name. Example: octo-org.
- `repo` (`string`, required): Name of the repository. Example: hello-world.

Example input: `{"owner":"<owner>","repo":"<repo>"}`

## Related

Other Developer Tools connectors ([all 200](/agentkit/connectors/?category=developer-tools)):

- [GitHub](/agentkit/connectors/github/): Scalekit connector, OAuth, 217 tools
- [Datadog](/agentkit/connectors/datadog/): Scalekit connector, API key, 105 tools
- [Linear](/agentkit/connectors/linear/): Scalekit connector, OAuth, 64 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
