> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Gitea

> Community managed lightweight code hosting solution written in Go

![Gitea logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/gitea.svg?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=f5254731757e33539bbdfa3fe1d0fc99)

* **Category:** developer tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 47
* **Triggers:** 0
* **Slug:** `GITEA`
* **Version:** 20261101\_00

## Tools

> [accordion] Get ActivityPub Person Actor
>
> **Slug:** `GITEA_ACTIVITYPUB_PERSON`
>
> Tool to retrieve the ActivityPub Person actor for a Gitea user. Use when you need to fetch a user's ActivityPub representation for federation purposes or to get ActivityStreams-formatted user data.
>
> #### Input Parameters
>
> **user\_id** `integer` *required*
>
> The numeric user ID of the Gitea user whose ActivityPub Person actor should be retrieved
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Issue Dependency
>
> **Slug:** `GITEA_ADD_ISSUE_DEPENDENCY`
>
> Make one repository issue depend on another issue.
>
> #### Input Parameters
>
> **repo** `string` *required*
>
> Repository containing the dependent issue.
>
> **index** `integer` *required*
>
> Index of the dependent issue.
>
> **owner** `string` *required*
>
> Owner of the dependent issue repository.
>
> **dependency\_repo** `string` *required*
>
> Repository containing the dependency issue.
>
> **dependency\_index** `integer` *required*
>
> Index of the dependency issue.
>
> **dependency\_owner** `string` *required*
>
> Owner of the dependency issue repository.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Cancel Workflow Run
>
> **Slug:** `GITEA_CANCEL_WORKFLOW_RUN`
>
> Cancel an active Actions workflow run and return its resulting state.
>
> #### Input Parameters
>
> **repo** `string` *required*
>
> Repository name.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **run\_id** `integer` *required*
>
> ID of the workflow run to cancel.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Change Repository Files
>
> **Slug:** `GITEA_CHANGE_REPOSITORY_FILES`
>
> Create, update, upload, rename, or delete files in one repository commit.
>
> #### Input Parameters
>
> **repo** `string` *required*
>
> Repository name.
>
> **dates** `object`
>
> Author and committer dates for the commit.
>
> **files** `array` *required*
>
> File operations to apply atomically in one commit.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **author** `object`
>
> Author identity for the commit.
>
> **branch** `string`
>
> Base branch for the changes; defaults to the repository default.
>
> **message** `string`
>
> Commit message; Gitea supplies a default when omitted.
>
> **signoff** `boolean`
>
> Whether to append a Signed-off-by trailer to the commit.
>
> **committer** `object`
>
> Committer identity for the commit.
>
> **force\_push** `boolean`
>
> Whether to force-push when the new branch already exists.
>
> **new\_branch** `string`
>
> New branch to create from the base branch for the changes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Branch
>
> **Slug:** `GITEA_CREATE_BRANCH`
>
> Create a repository branch from a branch, tag, or commit reference.
>
> #### Input Parameters
>
> **repo** `string` *required*
>
> Repository name.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **old\_ref\_name** `string`
>
> Source branch, tag, or commit; defaults to the repository default branch.
>
> **new\_branch\_name** `string` *required*
>
> Name of the branch to create.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Issue
>
> **Slug:** `GITEA_CREATE_ISSUE`
>
> Create an issue with optional assignments and repository relationships.
>
> #### Input Parameters
>
> **ref** `string`
>
> Git reference associated with the issue.
>
> **body** `string`
>
> Issue description.
>
> **repo** `string` *required*
>
> Repository name.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **title** `string` *required*
>
> Issue title.
>
> **closed** `boolean`
>
> Whether to create the issue in the closed state.
>
> **labels** `array`
>
> Repository label IDs to attach to the issue.
>
> **due\_date** `string`
>
> Issue due date as an RFC 3339 date-time. Gitea uses only the date portion.
>
> **projects** `array`
>
> Project IDs to associate with the issue.
>
> **assignees** `array`
>
> Login names of users to assign to the issue.
>
> **milestone** `integer`
>
> Repository milestone ID to assign.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Pull Request
>
> **Slug:** `GITEA_CREATE_PULL_REQUEST`
>
> Open a pull request between repository branches.
>
> #### Input Parameters
>
> **base** `string` *required*
>
> Target branch.
>
> **body** `string`
>
> Pull request description.
>
> **head** `string` *required*
>
> Source branch, optionally username:branch for a fork.
>
> **repo** `string` *required*
>
> Repository name.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **title** `string` *required*
>
> Pull request title.
>
> **labels** `array`
>
> Label IDs.
>
> **assignee** `string`
>
> Primary assignee username.
>
> **due\_date** `string`
>
> Due timestamp.
>
> **assignees** `array`
>
> Assignee usernames.
>
> **milestone** `integer`
>
> Milestone ID.
>
> **reviewers** `array`
>
> Reviewer usernames.
>
> **team\_reviewers** `array`
>
> Reviewer team names.
>
> **allow\_maintainer\_edit** `boolean`
>
> Whether maintainers may edit the source branch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Repository Label
>
> **Slug:** `GITEA_CREATE_REPOSITORY_LABEL`
>
> Create a repository label with configurable display and behavior settings.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Label display name.
>
> **repo** `string` *required*
>
> Repository name.
>
> **color** `string` *required*
>
> Label color as a hexadecimal value, with or without a leading #.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **exclusive** `boolean`
>
> Whether the label is exclusive within its scope.
>
> **description** `string`
>
> Label description.
>
> **is\_archived** `boolean`
>
> Whether the label is archived.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Dispatch Workflow
>
> **Slug:** `GITEA_DISPATCH_WORKFLOW`
>
> Trigger a workflow\_dispatch event and return the created run details.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Git reference to run the workflow from.
>
> **repo** `string` *required*
>
> Repository name.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **inputs** `object`
>
> String input values declared by the workflow\_dispatch trigger.
>
> **workflow\_id** `string` *required*
>
> Workflow file name or workflow ID.
>
> **scoped\_workflow\_source\_repo\_id** `integer`
>
> Source repository ID for a scoped workflow; omit for a repository-level workflow.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Branch
>
> **Slug:** `GITEA_GET_BRANCH`
>
> Retrieve a repository branch, its commit, and effective protection state.
>
> #### Input Parameters
>
> **repo** `string` *required*
>
> Repository name.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **branch** `string` *required*
>
> Branch name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Commit
>
> **Slug:** `GITEA_GET_COMMIT`
>
> Retrieve one repository commit by Git ref or SHA.
>
> #### Input Parameters
>
> **sha** `string` *required*
>
> Git ref or commit SHA.
>
> **repo** `string` *required*
>
> Repository name.
>
> **stat** `boolean`
>
> Whether to include diff statistics. Gitea defaults to true.
>
> **files** `boolean`
>
> Whether to include affected files. Gitea defaults to true.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **verification** `boolean`
>
> Whether to include signature verification. Gitea defaults to true.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Commit Status
>
> **Slug:** `GITEA_GET_COMMIT_STATUS`
>
> Get the combined status and individual checks for a commit reference.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Branch, tag, or commit reference.
>
> **page** `integer`
>
> Page number of statuses to return (1-based).
>
> **repo** `string` *required*
>
> Repository name.
>
> **limit** `integer`
>
> Number of statuses to return per page.
>
> **owner** `string` *required*
>
> Repository owner.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Current User
>
> **Slug:** `GITEA_GET_CURRENT_USER`
>
> Return the Gitea user authenticated by the connected API token.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get General API Settings
>
> **Slug:** `GITEA_GET_GENERAL_API_SETTINGS`
>
> Retrieve the Gitea instance's global API settings, including pagination limits and response size constraints.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get General Attachment Settings
>
> **Slug:** `GITEA_GET_GENERAL_ATTACHMENT_SETTINGS`
>
> Tool to retrieve the Gitea instance's global settings for file attachments including enabled status, allowed file types, size limits, and file count limits. Use when you need to understand the attachment configuration of the instance.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get General Repository Settings
>
> **Slug:** `GITEA_GET_GENERAL_REPOSITORY_SETTINGS`
>
> Tool to retrieve the Gitea instance's global settings for repositories including feature flags for mirroring, HTTP Git, migrations, stars, time tracking, and LFS. Use when you need to understand which repository features are enabled or disabled at the instance level.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get General UI Settings
>
> **Slug:** `GITEA_GET_GENERAL_UI_SETTINGS`
>
> Tool to retrieve the Gitea instance's global settings for UI including default theme, allowed reactions, and custom emojis. Use when you need to understand the UI configuration of the instance.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Gitignore Template Info
>
> **Slug:** `GITEA_GET_GITIGNORE_TEMPLATE_INFO`
>
> Tool to retrieve information about a specific gitignore template. Use when you need the content of a gitignore template for repository creation or configuration.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the gitignore template to retrieve (e.g., 'Go', 'Python', 'Node', 'Java').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Git Object
>
> **Slug:** `GITEA_GET_GIT_OBJECT`
>
> Retrieve a repository Git tree or blob by object SHA.
>
> #### Input Parameters
>
> **sha** `string` *required*
>
> Git object SHA or tree commit reference.
>
> **page** `integer`
>
> For trees, 1-based page number.
>
> **repo** `string` *required*
>
> Repository name.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **per\_page** `integer`
>
> For trees, number of entries to return per page.
>
> **recursive** `boolean`
>
> For trees, include entries from nested directories.
>
> **object\_type** `string ("tree" | "blob")` *required*
>
> Kind of Git object to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Label Template Info
>
> **Slug:** `GITEA_GET_LABEL_TEMPLATE_INFO`
>
> Tool to retrieve all labels from a specific label template. Use when you need to view the predefined label set for repository configuration.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the label template to retrieve (e.g., 'Default', 'Advanced'). This is the template identifier. Common templates include 'Default' and 'Advanced'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get License Template Info
>
> **Slug:** `GITEA_GET_LICENSE_TEMPLATE_INFO`
>
> Tool to retrieve information about a specific license template. Use when you need the content and details of a license template for repository creation or configuration.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the license template to retrieve. This should be the unique identifier for the license (e.g., 'mit', 'apache-2.0', 'gpl-3.0').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Node Info
>
> **Slug:** `GITEA_GET_NODE_INFO`
>
> Tool to retrieve the nodeinfo of the Gitea application. Use when you need standardized metadata about the Gitea server following the NodeInfo specification.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Pull Request
>
> **Slug:** `GITEA_GET_PULL_REQUEST`
>
> Retrieve one pull request and its current merge state and references.
>
> #### Input Parameters
>
> **repo** `string` *required*
>
> Repository name.
>
> **index** `integer` *required*
>
> Pull request index.
>
> **owner** `string` *required*
>
> Repository owner.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Release by Tag
>
> **Slug:** `GITEA_GET_RELEASE_BY_TAG`
>
> Retrieve a repository release by its exact tag name.
>
> #### Input Parameters
>
> **tag** `string` *required*
>
> Exact release tag name.
>
> **repo** `string` *required*
>
> Repository name.
>
> **owner** `string` *required*
>
> Repository owner.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Repository
>
> **Slug:** `GITEA_GET_REPOSITORY`
>
> Retrieve metadata and capabilities for one repository.
>
> #### Input Parameters
>
> **repo** `string` *required*
>
> Repository name.
>
> **owner** `string` *required*
>
> Repository owner.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Repository Contents
>
> **Slug:** `GITEA_GET_REPOSITORY_CONTENTS`
>
> Retrieve file content or directory entries from a repository path.
>
> #### Input Parameters
>
> **ref** `string`
>
> Commit SHA, branch, or tag to read. Defaults to the repository's default branch.
>
> **repo** `string` *required*
>
> Repository name.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **filepath** `string` *required*
>
> Path to a file, directory, symlink, or submodule.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Signing Key
>
> **Slug:** `GITEA_GET_SIGNING_KEY`
>
> Tool to retrieve the default GPG signing key used by Gitea to sign commits. Use when you need to verify commits signed by the Gitea instance or import the public key to trust Gitea-generated commits.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Version
>
> **Slug:** `GITEA_GET_VERSION`
>
> Tool to retrieve the version of the Gitea application. Use when you need to check the Gitea server version.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow Job
>
> **Slug:** `GITEA_GET_WORKFLOW_JOB`
>
> Get structured status and step details for one Gitea Actions job.
>
> #### Input Parameters
>
> **repo** `string` *required*
>
> Repository name.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **job\_id** `string` *required*
>
> Workflow job ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow Job Logs
>
> **Slug:** `GITEA_GET_WORKFLOW_JOB_LOGS`
>
> Retrieve the plain-text diagnostic log for a repository Actions job.
>
> #### Input Parameters
>
> **repo** `string` *required*
>
> Repository name.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **job\_id** `integer` *required*
>
> Numeric identifier of the Actions job whose logs to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Branches
>
> **Slug:** `GITEA_LIST_BRANCHES`
>
> List branches and their head commits for a Gitea repository. Optionally filter branch names by a search term and select a page and page size; the result includes pagination information when available. Requires repository read permission.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number of branches to return (1-based).
>
> **repo** `string` *required*
>
> Repository name.
>
> **limit** `integer`
>
> Maximum number of branches to return per page.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **query** `string`
>
> Search term used to filter branch names.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Commits
>
> **Slug:** `GITEA_LIST_COMMITS`
>
> List and filter commits in a repository.
>
> #### Input Parameters
>
> **not** `string`
>
> Exclude commits matching this Git revision specifier.
>
> **sha** `string`
>
> Commit SHA or branch from which to start listing.
>
> **page** `integer`
>
> Page number of results to return (1-based).
>
> **path** `string`
>
> Only return commits affecting this repository path.
>
> **repo** `string` *required*
>
> Repository name.
>
> **stat** `boolean`
>
> Whether to include diff statistics for each commit.
>
> **files** `boolean`
>
> Whether to include affected files for each commit.
>
> **limit** `integer`
>
> Number of commits to return per page; ignored when path is used.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **since** `string`
>
> Only return commits after this ISO 8601 timestamp.
>
> **until** `string`
>
> Only return commits before this ISO 8601 timestamp.
>
> **verification** `boolean`
>
> Whether to include signature verification for each commit.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Gitignore Templates
>
> **Slug:** `GITEA_LIST_GITIGNORE_TEMPLATES`
>
> Tool to retrieve all available gitignore templates. Use when creating a repository to select an appropriate .gitignore template.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Issue Comments
>
> **Slug:** `GITEA_LIST_ISSUE_COMMENTS`
>
> List comments on a repository issue, optionally bounded by update time.
>
> #### Input Parameters
>
> **repo** `string` *required*
>
> Repository name.
>
> **index** `integer` *required*
>
> Issue index.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **since** `string`
>
> Only return comments updated since this ISO 8601 timestamp.
>
> **before** `string`
>
> Only return comments updated before this ISO 8601 timestamp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Label Templates
>
> **Slug:** `GITEA_LIST_LABEL_TEMPLATES`
>
> Tool to retrieve all available label templates. Use when you need to discover which predefined label sets are available for repositories.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List License Templates
>
> **Slug:** `GITEA_LIST_LICENSE_TEMPLATES`
>
> Tool to retrieve all available license templates. Use when creating a repository to select an appropriate license template.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Pull Request Files
>
> **Slug:** `GITEA_LIST_PULL_REQUEST_FILES`
>
> List files changed by a pull request.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number of results to return (1-based).
>
> **repo** `string` *required*
>
> Repository name.
>
> **index** `integer` *required*
>
> Pull request index.
>
> **limit** `integer`
>
> Number of changed files to return per page.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **skip\_to** `string`
>
> Start the page at this changed file path.
>
> **whitespace** `string ("ignore-all" | "ignore-change" | "ignore-eol" | "show-all")`
>
> Whitespace handling for the file diff.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Pull Requests
>
> **Slug:** `GITEA_LIST_PULL_REQUESTS`
>
> Filter and list pull requests in a repository.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number of results to return (1-based).
>
> **repo** `string` *required*
>
> Repository name.
>
> **sort** `string ("oldest" | "recentupdate" | "recentclose" | "leastupdate" | "mostcomment" | "leastcomment" | "priority")`
>
> Ordering to apply to matching pull requests.
>
> **limit** `integer`
>
> Number of pull requests to return per page.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **state** `string ("open" | "closed" | "all")`
>
> Pull request state to return.
>
> **labels** `array`
>
> Only return pull requests with these label IDs.
>
> **milestone** `integer`
>
> Only return pull requests assigned to this milestone ID.
>
> **base\_branch** `string`
>
> Only return pull requests targeting this base branch.
>
> **author\_username** `string`
>
> Only return pull requests authored by this user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workflow Run Jobs
>
> **Slug:** `GITEA_LIST_WORKFLOW_RUN_JOBS`
>
> List jobs and step outcomes for one repository Actions workflow run.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number of results to return (1-based).
>
> **repo** `string` *required*
>
> Repository name.
>
> **sort** `string`
>
> Job attribute to sort by. Gitea currently supports id.
>
> **limit** `integer`
>
> Number of workflow jobs to return per page.
>
> **order** `string ("asc" | "desc")`
>
> Sort order for jobs.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **run\_id** `integer` *required*
>
> Workflow run ID.
>
> **status** `string ("pending" | "queued" | "in_progress" | "failure" | "success" | "skipped")`
>
> Workflow job status to match.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workflow Runs
>
> **Slug:** `GITEA_LIST_WORKFLOW_RUNS`
>
> List and filter Actions workflow runs for a repository.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number of results to return (1-based).
>
> **repo** `string` *required*
>
> Repository name.
>
> **actor** `string`
>
> Username of the user who triggered the run.
>
> **event** `string`
>
> Workflow event name to match.
>
> **limit** `integer`
>
> Number of workflow runs to return per page.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **branch** `string`
>
> Head branch to match.
>
> **status** `string ("pending" | "queued" | "in_progress" | "failure" | "success" | "skipped")`
>
> Workflow run status to match.
>
> **head\_sha** `string`
>
> Triggering commit SHA to match.
>
> **exclude\_pull\_requests** `boolean`
>
> Whether to omit pull request details from returned runs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Merge Pull Request
>
> **Slug:** `GITEA_MERGE_PULL_REQUEST`
>
> Merge now or after checks using a selected strategy, with optional requirement bypass and source-branch deletion.
>
> #### Input Parameters
>
> **repo** `string` *required*
>
> Repository name.
>
> **index** `integer` *required*
>
> Pull request index.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **force\_merge** `boolean`
>
> Whether to merge despite unmet merge requirements.
>
> **head\_commit\_id** `string`
>
> Expected head commit ID for the pull request.
>
> **merge\_strategy** `string ("merge" | "rebase" | "rebase-merge" | "squash" | "fast-forward-only" | "manually-merged")` *required*
>
> Strategy to use when merging the pull request.
>
> **merge\_commit\_id** `string`
>
> Commit ID for a manually merged pull request.
>
> **merge\_title\_field** `string`
>
> Title for the merge commit.
>
> **merge\_message\_field** `string`
>
> Message for the merge commit.
>
> **delete\_branch\_after\_merge** `boolean`
>
> Whether to delete the source branch after merging.
>
> **merge\_when\_checks\_succeed** `boolean`
>
> Whether to schedule the merge after checks succeed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get All Organizations
>
> **Slug:** `GITEA_ORG_GET_ALL`
>
> Tool to retrieve a paginated list of all organizations in the Gitea instance. Use when you need to list all organizations or browse organizations with pagination support.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number of results to return (1-based). If not specified, returns the first page.
>
> **limit** `integer`
>
> Page size of results (number of organizations per page). If not specified, uses server default.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Organization Actions Secrets
>
> **Slug:** `GITEA_ORG_LIST_ACTIONS_SECRETS`
>
> List a page of an organization's Actions secrets, with optional pagination. The response contains secret metadata rather than secret values.
>
> #### Input Parameters
>
> **org** `string` *required*
>
> Name of the organization
>
> **page** `integer`
>
> Page number of results to return (1-based). Default pagination starts at page 1.
>
> **limit** `integer`
>
> Page size of results (number of items per page). Default is typically 50.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Render Markdown
>
> **Slug:** `GITEA_RENDER_MARKDOWN`
>
> Tool to render a markdown document as HTML with configurable rendering modes and context. Use when you need to convert markdown to HTML with specific rendering contexts like comments, wiki pages, or files.
>
> #### Input Parameters
>
> **mode** `string ("markdown" | "comment" | "wiki" | "file")`
>
> Rendering mode that specifies the context for rendering. Options: 'markdown' (default/standard), 'comment' (for issues/pull requests), 'wiki' (wiki pages), 'file' (file content).
>
> **text** `string` *required*
>
> The markdown content to be rendered into HTML. Supports standard markdown syntax.
>
> **wiki** `boolean`
>
> DEPRECATED: Legacy flag indicating wiki page content. Use mode='wiki' instead.
>
> **context** `string`
>
> URL path for resolving relative links to issues, media, and files. Expected format: /subpath/\{user}/\{repo}/src/\{branch,commit,tag}/\{identifier/path}/\{file/dir}
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Render Markdown Raw
>
> **Slug:** `GITEA_RENDER_MARKDOWN_RAW`
>
> Tool to render raw markdown text as HTML. Use when you need to convert markdown content to HTML format for display or processing.
>
> #### Input Parameters
>
> **markdown\_text** `string` *required*
>
> Raw markdown text to render as HTML. Supports standard markdown syntax including headers, bold, italic, lists, links, images, code blocks, etc.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Render Markup
>
> **Slug:** `GITEA_RENDER_MARKUP`
>
> Tool to render a markup document as HTML with support for multiple markup formats. Use when you need to convert markup content (Markdown, AsciiDoc, etc.) to HTML with specific rendering contexts like comments, wiki pages, or files.
>
> #### Input Parameters
>
> **mode** `string ("markdown" | "comment" | "wiki" | "file")`
>
> Rendering mode that specifies the context for rendering. Options: 'markdown' (default/standard), 'comment' (for issues/pull requests), 'wiki' (wiki pages), 'file' (file content with extension detection).
>
> **text** `string` *required*
>
> The markup content to be rendered into HTML. Supports various markup formats including Markdown, AsciiDoc, and others depending on the mode.
>
> **wiki** `boolean`
>
> DEPRECATED: Legacy flag indicating wiki page content. Use mode='wiki' instead.
>
> **context** `string`
>
> URL path for resolving relative links to issues, media, and files. Expected format: /subpath/\{user}/\{repo}/src/\{branch,commit,tag}/\{identifier/path}/\{file/dir}
>
> **file\_path** `string`
>
> File path for detecting the markup extension when using mode='file'. Used to determine the appropriate markup renderer based on file extension.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upsert Repository File
>
> **Slug:** `GITEA_UPSERT_REPOSITORY_FILE`
>
> Create, update, move, or rename a file, optionally on a new branch with force-push.
>
> #### Input Parameters
>
> **sha** `string`
>
> Current blob SHA when updating an existing file; omit to create a file.
>
> **repo** `string` *required*
>
> Repository name.
>
> **dates** `object`
>
> Author and committer dates for the commit.
>
> **owner** `string` *required*
>
> Repository owner.
>
> **author** `object`
>
> Author identity for the commit.
>
> **branch** `string`
>
> Base branch for the change; defaults to the repository default.
>
> **content** `string` *required*
>
> New file content encoded as base64.
>
> **message** `string`
>
> Commit message; Gitea supplies a default when omitted.
>
> **signoff** `boolean`
>
> Whether to append a Signed-off-by trailer to the commit.
>
> **filepath** `string` *required*
>
> Path of the file to create, update, or move.
>
> **committer** `object`
>
> Committer identity for the commit.
>
> **from\_path** `string`
>
> Original file path when moving or renaming a file.
>
> **force\_push** `boolean`
>
> Whether to force-push when the new branch already exists.
>
> **new\_branch** `string`
>
> New branch to create from the base branch for the change.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
