---

name: go-sdk description: Use when writing Go code to interact with Gitea API - automation, bots, integrations, migrations, or programmatic git forge operations

Gitea Go SDK

Overview

The official Go SDK for Gitea provides 332+ API methods with full type safety. Use it for bots, automation, integrations, and complex workflows. For quick CLI operations, use gitea:tea-cli instead.

Quick Setup

Copyimport "code.gitea.io/sdk/gitea"

// Create client
client, err := gitea.NewClient(
    "https://gitea.example.com",
    gitea.SetToken("your-token"),
)

Copygo get code.gitea.io/sdk/gitea

See references/authentication.md in tea-cli for token creation.

Quick Reference

API Categories

See references/api-reference.md for complete method list:

• Repositories (70+ methods)
• Issues & comments (50+ methods)
• Pull requests & reviews (40+ methods)
• Releases & attachments
• Organizations & teams
• Users, webhooks, actions

Common Types

See references/types.md for struct definitions:

• Repository, Issue, PullRequest, Release
• User, Organization, Team
• ListOptions for pagination
• Option structs for create/edit

Patterns

See references/examples.md for idiomatic patterns:

• Error handling
• Pagination
• Context usage
• Webhook handlers

Authentication Options

Copy// Token auth (recommended)
client, _ := gitea.NewClient(url, gitea.SetToken(token))

// Basic auth
client, _ := gitea.NewClient(url, gitea.SetBasicAuth(user, pass))

// With 2FA
client, _ := gitea.NewClient(url,
    gitea.SetBasicAuth(user, pass),
    gitea.SetOTP(otp),
)

// SSH key
client, _ := gitea.NewClient(url,
    gitea.UseSSHPubkey(fingerprint, keyPath, passphrase),
)

Common Patterns

Copy// Pagination
opts := gitea.ListOptions{Page: 1, PageSize: 50}
for {
    repos, resp, _ := client.ListMyRepos(gitea.ListReposOptions{ListOptions: opts})
    // process repos...
    if resp.NextPage == 0 {
        break
    }
    opts.Page = resp.NextPage
}

// Context support
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
client.SetContext(ctx)

Common Mistakes