G

gitea.com

Gitea is a self-hosted and hosted Git forge for source code hosting, code review, issues, packages, and related collaboration workflows. The `gitea.com` domain hosts the public service and its documentation.

2 integrations · REST

Gitea exposes a REST API at `https://gitea.com/api/v1` plus an OAuth2/OpenID Connect provider on the main host; documented auth options include personal access tokens, HTTP Basic auth, SSH-based HTTP signatures, and OAuth2 app credentials.

discovered 2mo ago
REST · OpenAPI2
Credentials
Personal access tokenapi_keyGet key

In Gitea, open User Settings → Applications and use Manage Access Tokens to create a token. Choose the needed permission scopes; Gitea shows the token only once. The docs also note tokens can be minted via the API at /api/v1/users/{username}/tokens using HTTP Basic auth with your username and password.

Gitea username and passwordbasicGet credentials

Sign in to your Gitea account at gitea.com login. The API docs state HTTP Basic authentication is supported, and that creating tokens via /api/v1/users/{username}/tokens specifically requires Basic auth with your username and password.

Registered SSH key or SSH certificate for HTTP signaturessignatureGet key

Add an SSH public key or SSH certificate to your Gitea account in User Settings → SSH / GPG Keys. Then sign API requests with the matching private key using the draft-cavage HTTP Signatures format; send the signature in the Signature header, and include x-ssh-certificate when using an SSH certificate.

OAuth2 application client credentialsoauth2Set up OAuth

Register an OAuth2 application in Gitea from User Settings → Applications or, for admins, the instance application pages described in the docs. Create an app with a name and redirect URL, then copy the generated Client ID and Client Secret. Use those in the standard OAuth flow against Gitea’s OAuth endpoints; user consent is required.

conventions · 0/7 published

Publish these signals → /publishing