Gitea | Composio Docs

Overview

SLUG: GITEA

Description

Community managed lightweight code hosting solution written in Go

Authentication Details

API Key

full

stringDefaults to https://gitea.com/api/v1Required

generic_api_key

stringRequired

Connecting to Gitea

Create an auth config

Use the dashboard to create an auth config for the Gitea toolkit. This allows you to connect multiple Gitea accounts to Composio for agents to use.

Select App

Navigate to Gitea.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Gitea Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 gitea_auth_config_id = "ac_YOUR_GITEA_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Gitea for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, gitea_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Gitea toolkit’s playground

For code examples, see the Tool calling guide and Provider examples.

Tool List

GITEA_ACTIVITYPUB_PERSON

Tool Name: Get ActivityPub Person Actor

Description

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.

Action Parameters

user_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_GET_GENERAL_API_SETTINGS

Tool Name: Get General API Settings

Description

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.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_GET_GENERAL_ATTACHMENT_SETTINGS

Tool Name: Get General Attachment Settings

Description

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.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_GET_GENERAL_REPOSITORY_SETTINGS

Tool Name: Get General Repository Settings

Description

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.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_GET_GENERAL_UI_SETTINGS

Tool Name: Get General UI Settings

Description

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.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_GET_GITIGNORE_TEMPLATE_INFO

Tool Name: Get Gitignore Template Info

Description

Tool to retrieve information about a specific gitignore template. Use when you need the content of a gitignore template for repository creation or configuration.

Action Parameters

name

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_GET_LABEL_TEMPLATE_INFO

Tool Name: Get Label Template Info

Description

Tool to retrieve all labels from a specific label template. Use when you need to view the predefined label set for repository configuration.

Action Parameters

name

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_GET_LICENSE_TEMPLATE_INFO

Tool Name: Get License Template Info

Description

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.

Action Parameters

name

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_GET_NODE_INFO

Tool Name: Get Node Info

Description

Tool to retrieve the nodeinfo of the Gitea application. Use when you need standardized metadata about the Gitea server following the NodeInfo specification.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_GET_SIGNING_KEY

Tool Name: Get Signing Key

Description

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.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_GET_VERSION

Tool Name: Get Version

Description

Tool to retrieve the version of the Gitea application. Use when you need to check the Gitea server version.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_LIST_GITIGNORE_TEMPLATES

Tool Name: List Gitignore Templates

Description

Tool to retrieve all available gitignore templates. Use when creating a repository to select an appropriate .gitignore template.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_LIST_LABEL_TEMPLATES

Tool Name: List Label Templates

Description

Tool to retrieve all available label templates. Use when you need to discover which predefined label sets are available for repositories.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_LIST_LICENSE_TEMPLATES

Tool Name: List License Templates

Description

Tool to retrieve all available license templates. Use when creating a repository to select an appropriate license template.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_ORG_GET_ALL

Tool Name: Get All Organizations

Description

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.

Action Parameters

limit

integer

page

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_ORG_LIST_ACTIONS_SECRETS

Tool Name: List Organization Actions Secrets

Description

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.

Action Parameters

limit

integer

org

stringRequired

page

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_RENDER_MARKDOWN

Tool Name: Render Markdown

Description

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.

Action Parameters

context

string

mode

string

text

stringRequired

wiki

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_RENDER_MARKDOWN_RAW

Tool Name: Render Markdown Raw

Description

Tool to render raw markdown text as HTML. Use when you need to convert markdown content to HTML format for display or processing.

Action Parameters

markdown_text

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

GITEA_RENDER_MARKUP

Tool Name: Render Markup

Description

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.

Action Parameters

context

string

file_path

string

mode

string

text

stringRequired

wiki

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired