Skip to main content
Gitea logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 47
  • Triggers: 0
  • Slug: GITEA
  • Version: 20261101_00

Tools

Slug: GITEA_ACTIVITYPUB_PERSONTool 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

integer
required
The numeric user ID of the Gitea user whose ActivityPub Person actor should be retrieved

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_ADD_ISSUE_DEPENDENCYMake one repository issue depend on another issue.

Input Parameters

string
required
Repository containing the dependent issue.
integer
required
Index of the dependent issue.
string
required
Owner of the dependent issue repository.
string
required
Repository containing the dependency issue.
integer
required
Index of the dependency issue.
string
required
Owner of the dependency issue repository.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_CANCEL_WORKFLOW_RUNCancel an active Actions workflow run and return its resulting state.

Input Parameters

string
required
Repository name.
string
required
Repository owner.
integer
required
ID of the workflow run to cancel.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_CHANGE_REPOSITORY_FILESCreate, update, upload, rename, or delete files in one repository commit.

Input Parameters

string
required
Repository name.
object
Author and committer dates for the commit.
array
required
File operations to apply atomically in one commit.
string
required
Repository owner.
object
Author identity for the commit.
string
Base branch for the changes; defaults to the repository default.
string
Commit message; Gitea supplies a default when omitted.
boolean
Whether to append a Signed-off-by trailer to the commit.
object
Committer identity for the commit.
boolean
Whether to force-push when the new branch already exists.
string
New branch to create from the base branch for the changes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_CREATE_BRANCHCreate a repository branch from a branch, tag, or commit reference.

Input Parameters

string
required
Repository name.
string
required
Repository owner.
string
Source branch, tag, or commit; defaults to the repository default branch.
string
required
Name of the branch to create.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_CREATE_ISSUECreate an issue with optional assignments and repository relationships.

Input Parameters

string
Git reference associated with the issue.
string
Issue description.
string
required
Repository name.
string
required
Repository owner.
string
required
Issue title.
boolean
Whether to create the issue in the closed state.
array
Repository label IDs to attach to the issue.
string
Issue due date as an RFC 3339 date-time. Gitea uses only the date portion.
array
Project IDs to associate with the issue.
array
Login names of users to assign to the issue.
integer
Repository milestone ID to assign.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_CREATE_PULL_REQUESTOpen a pull request between repository branches.

Input Parameters

string
required
Target branch.
string
Pull request description.
string
required
Source branch, optionally username:branch for a fork.
string
required
Repository name.
string
required
Repository owner.
string
required
Pull request title.
array
Label IDs.
string
Primary assignee username.
string
Due timestamp.
array
Assignee usernames.
integer
Milestone ID.
array
Reviewer usernames.
array
Reviewer team names.
boolean
Whether maintainers may edit the source branch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_CREATE_REPOSITORY_LABELCreate a repository label with configurable display and behavior settings.

Input Parameters

string
required
Label display name.
string
required
Repository name.
string
required
Label color as a hexadecimal value, with or without a leading #.
string
required
Repository owner.
boolean
Whether the label is exclusive within its scope.
string
Label description.
boolean
Whether the label is archived.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_DISPATCH_WORKFLOWTrigger a workflow_dispatch event and return the created run details.

Input Parameters

string
required
Git reference to run the workflow from.
string
required
Repository name.
string
required
Repository owner.
object
String input values declared by the workflow_dispatch trigger.
string
required
Workflow file name or workflow ID.
integer
Source repository ID for a scoped workflow; omit for a repository-level workflow.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_BRANCHRetrieve a repository branch, its commit, and effective protection state.

Input Parameters

string
required
Repository name.
string
required
Repository owner.
string
required
Branch name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_COMMITRetrieve one repository commit by Git ref or SHA.

Input Parameters

string
required
Git ref or commit SHA.
string
required
Repository name.
boolean
Whether to include diff statistics. Gitea defaults to true.
boolean
Whether to include affected files. Gitea defaults to true.
string
required
Repository owner.
boolean
Whether to include signature verification. Gitea defaults to true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_COMMIT_STATUSGet the combined status and individual checks for a commit reference.

Input Parameters

string
required
Branch, tag, or commit reference.
integer
Page number of statuses to return (1-based).
string
required
Repository name.
integer
Number of statuses to return per page.
string
required
Repository owner.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_CURRENT_USERReturn the Gitea user authenticated by the connected API token.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_GENERAL_API_SETTINGSRetrieve the Gitea instance’s global API settings, including pagination limits and response size constraints.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_GENERAL_ATTACHMENT_SETTINGSTool 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_GENERAL_REPOSITORY_SETTINGSTool 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_GENERAL_UI_SETTINGSTool 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_GITIGNORE_TEMPLATE_INFOTool 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

string
required
Name of the gitignore template to retrieve (e.g., ‘Go’, ‘Python’, ‘Node’, ‘Java’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_GIT_OBJECTRetrieve a repository Git tree or blob by object SHA.

Input Parameters

string
required
Git object SHA or tree commit reference.
integer
For trees, 1-based page number.
string
required
Repository name.
string
required
Repository owner.
integer
For trees, number of entries to return per page.
boolean
For trees, include entries from nested directories.
string ("tree" | "blob")
required
Kind of Git object to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_LABEL_TEMPLATE_INFOTool to retrieve all labels from a specific label template. Use when you need to view the predefined label set for repository configuration.

Input Parameters

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_LICENSE_TEMPLATE_INFOTool 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_NODE_INFOTool to retrieve the nodeinfo of the Gitea application. Use when you need standardized metadata about the Gitea server following the NodeInfo specification.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_PULL_REQUESTRetrieve one pull request and its current merge state and references.

Input Parameters

string
required
Repository name.
integer
required
Pull request index.
string
required
Repository owner.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_RELEASE_BY_TAGRetrieve a repository release by its exact tag name.

Input Parameters

string
required
Exact release tag name.
string
required
Repository name.
string
required
Repository owner.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_REPOSITORYRetrieve metadata and capabilities for one repository.

Input Parameters

string
required
Repository name.
string
required
Repository owner.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_REPOSITORY_CONTENTSRetrieve file content or directory entries from a repository path.

Input Parameters

string
Commit SHA, branch, or tag to read. Defaults to the repository’s default branch.
string
required
Repository name.
string
required
Repository owner.
string
required
Path to a file, directory, symlink, or submodule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_SIGNING_KEYTool 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_VERSIONTool to retrieve the version of the Gitea application. Use when you need to check the Gitea server version.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_WORKFLOW_JOBGet structured status and step details for one Gitea Actions job.

Input Parameters

string
required
Repository name.
string
required
Repository owner.
string
required
Workflow job ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_GET_WORKFLOW_JOB_LOGSRetrieve the plain-text diagnostic log for a repository Actions job.

Input Parameters

string
required
Repository name.
string
required
Repository owner.
integer
required
Numeric identifier of the Actions job whose logs to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_LIST_BRANCHESList 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

integer
Page number of branches to return (1-based).
string
required
Repository name.
integer
Maximum number of branches to return per page.
string
required
Repository owner.
string
Search term used to filter branch names.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_LIST_COMMITSList and filter commits in a repository.

Input Parameters

string
Exclude commits matching this Git revision specifier.
string
Commit SHA or branch from which to start listing.
integer
Page number of results to return (1-based).
string
Only return commits affecting this repository path.
string
required
Repository name.
boolean
Whether to include diff statistics for each commit.
boolean
Whether to include affected files for each commit.
integer
Number of commits to return per page; ignored when path is used.
string
required
Repository owner.
string
Only return commits after this ISO 8601 timestamp.
string
Only return commits before this ISO 8601 timestamp.
boolean
Whether to include signature verification for each commit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_LIST_GITIGNORE_TEMPLATESTool to retrieve all available gitignore templates. Use when creating a repository to select an appropriate .gitignore template.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_LIST_ISSUE_COMMENTSList comments on a repository issue, optionally bounded by update time.

Input Parameters

string
required
Repository name.
integer
required
Issue index.
string
required
Repository owner.
string
Only return comments updated since this ISO 8601 timestamp.
string
Only return comments updated before this ISO 8601 timestamp.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_LIST_LABEL_TEMPLATESTool to retrieve all available label templates. Use when you need to discover which predefined label sets are available for repositories.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_LIST_LICENSE_TEMPLATESTool to retrieve all available license templates. Use when creating a repository to select an appropriate license template.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_LIST_PULL_REQUEST_FILESList files changed by a pull request.

Input Parameters

integer
Page number of results to return (1-based).
string
required
Repository name.
integer
required
Pull request index.
integer
Number of changed files to return per page.
string
required
Repository owner.
string
Start the page at this changed file path.
string ("ignore-all" | "ignore-change" | "ignore-eol" | "show-all")
Whitespace handling for the file diff.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_LIST_PULL_REQUESTSFilter and list pull requests in a repository.

Input Parameters

integer
Page number of results to return (1-based).
string
required
Repository name.
string ("oldest" | "recentupdate" | "recentclose" | "leastupdate" | "mostcomment" | "leastcomment" | "priority")
Ordering to apply to matching pull requests.
integer
Number of pull requests to return per page.
string
required
Repository owner.
string ("open" | "closed" | "all")
Pull request state to return.
array
Only return pull requests with these label IDs.
integer
Only return pull requests assigned to this milestone ID.
string
Only return pull requests targeting this base branch.
string
Only return pull requests authored by this user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_LIST_WORKFLOW_RUN_JOBSList jobs and step outcomes for one repository Actions workflow run.

Input Parameters

integer
Page number of results to return (1-based).
string
required
Repository name.
string
Job attribute to sort by. Gitea currently supports id.
integer
Number of workflow jobs to return per page.
string ("asc" | "desc")
Sort order for jobs.
string
required
Repository owner.
integer
required
Workflow run ID.
string ("pending" | "queued" | "in_progress" | "failure" | "success" | "skipped")
Workflow job status to match.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_LIST_WORKFLOW_RUNSList and filter Actions workflow runs for a repository.

Input Parameters

integer
Page number of results to return (1-based).
string
required
Repository name.
string
Username of the user who triggered the run.
string
Workflow event name to match.
integer
Number of workflow runs to return per page.
string
required
Repository owner.
string
Head branch to match.
string ("pending" | "queued" | "in_progress" | "failure" | "success" | "skipped")
Workflow run status to match.
string
Triggering commit SHA to match.
boolean
Whether to omit pull request details from returned runs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_MERGE_PULL_REQUESTMerge now or after checks using a selected strategy, with optional requirement bypass and source-branch deletion.

Input Parameters

string
required
Repository name.
integer
required
Pull request index.
string
required
Repository owner.
boolean
Whether to merge despite unmet merge requirements.
string
Expected head commit ID for the pull request.
string ("merge" | "rebase" | "rebase-merge" | "squash" | "fast-forward-only" | "manually-merged")
required
Strategy to use when merging the pull request.
string
Commit ID for a manually merged pull request.
string
Title for the merge commit.
string
Message for the merge commit.
boolean
Whether to delete the source branch after merging.
boolean
Whether to schedule the merge after checks succeed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_ORG_GET_ALLTool 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

integer
Page number of results to return (1-based). If not specified, returns the first page.
integer
Page size of results (number of organizations per page). If not specified, uses server default.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_ORG_LIST_ACTIONS_SECRETSList a page of an organization’s Actions secrets, with optional pagination. The response contains secret metadata rather than secret values.

Input Parameters

string
required
Name of the organization
integer
Page number of results to return (1-based). Default pagination starts at page 1.
integer
Page size of results (number of items per page). Default is typically 50.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_RENDER_MARKDOWNTool 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

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).
string
required
The markdown content to be rendered into HTML. Supports standard markdown syntax.
boolean
DEPRECATED: Legacy flag indicating wiki page content. Use mode=‘wiki’ instead.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_RENDER_MARKDOWN_RAWTool to render raw markdown text as HTML. Use when you need to convert markdown content to HTML format for display or processing.

Input Parameters

string
required
Raw markdown text to render as HTML. Supports standard markdown syntax including headers, bold, italic, lists, links, images, code blocks, etc.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_RENDER_MARKUPTool 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

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).
string
required
The markup content to be rendered into HTML. Supports various markup formats including Markdown, AsciiDoc, and others depending on the mode.
boolean
DEPRECATED: Legacy flag indicating wiki page content. Use mode=‘wiki’ instead.
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}
string
File path for detecting the markup extension when using mode=‘file’. Used to determine the appropriate markup renderer based on file extension.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITEA_UPSERT_REPOSITORY_FILECreate, update, move, or rename a file, optionally on a new branch with force-push.

Input Parameters

string
Current blob SHA when updating an existing file; omit to create a file.
string
required
Repository name.
object
Author and committer dates for the commit.
string
required
Repository owner.
object
Author identity for the commit.
string
Base branch for the change; defaults to the repository default.
string
required
New file content encoded as base64.
string
Commit message; Gitea supplies a default when omitted.
boolean
Whether to append a Signed-off-by trailer to the commit.
string
required
Path of the file to create, update, or move.
object
Committer identity for the commit.
string
Original file path when moving or renaming a file.
boolean
Whether to force-push when the new branch already exists.
string
New branch to create from the base branch for the change.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not