# Gitea

Community managed lightweight code hosting solution written in Go

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 19
- **Triggers:** 0
- **Slug:** `GITEA`
- **Version:** 20260203_00

## Tools

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | integer | Yes | The numeric user ID of the Gitea user whose ActivityPub Person actor should be retrieved |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get General API Settings

**Slug:** `GITEA_GET_GENERAL_API_SETTINGS`

Tool to retrieve the Gitea instance's global API settings including pagination limits and response size constraints. Use when you need to understand API rate limits or configuration parameters.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the gitignore template to retrieve (e.g., 'Go', 'Python', 'Node', 'Java'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name of the label template to retrieve (e.g., 'Default', 'Advanced'). This is the template identifier. Common templates include 'Default' and 'Advanced'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number of results to return (1-based). If not specified, returns the first page. |
| `limit` | integer | No | Page size of results (number of organizations per page). If not specified, uses server default. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organization Actions Secrets

**Slug:** `GITEA_ORG_LIST_ACTIONS_SECRETS`

Tool to list all action secrets for an organization. Use when you need to retrieve the list of secrets configured at the organization level. Note that secret values are never returned through the API for security purposes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org` | string | Yes | Name of the organization |
| `page` | integer | No | Page number of results to return (1-based). Default pagination starts at page 1. |
| `limit` | integer | No | Page size of results (number of items per page). Default is typically 50. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("markdown" | "comment" | "wiki" | "file") | No | 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 | Yes | The markdown content to be rendered into HTML. Supports standard markdown syntax. |
| `wiki` | boolean | No | DEPRECATED: Legacy flag indicating wiki page content. Use mode='wiki' instead. |
| `context` | string | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `markdown_text` | string | Yes | Raw markdown text to render as HTML. Supports standard markdown syntax including headers, bold, italic, lists, links, images, code blocks, etc. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("markdown" | "comment" | "wiki" | "file") | No | 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 | Yes | The markup content to be rendered into HTML. Supports various markup formats including Markdown, AsciiDoc, and others depending on the mode. |
| `wiki` | boolean | No | DEPRECATED: Legacy flag indicating wiki page content. Use mode='wiki' instead. |
| `context` | string | No | 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 | No | File path for detecting the markup extension when using mode='file'. Used to determine the appropriate markup renderer based on file extension. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |