gitea-api
Installation
SKILL.md
Gitea REST API (v1.26)
Base: https://gitea.example.com/api/v1. Swagger: https://gitea.example.com/api/swagger. OpenAPI spec: https://gitea.example.com/swagger.v1.json.
Authentication
| Method | Header / Param | Use Case |
|---|---|---|
| Token | Authorization: token <token> |
API tokens from Settings > Applications |
| Basic Auth | -u username:password |
Creating tokens (POST /users/:name/tokens) |
| OAuth2 Bearer | Authorization: bearer <token> |
OAuth2 access tokens |
| URL param | ?token=<token> |
Simple scripts |
| SSH signatures | Signature header with SSH key |
mTLS-style auth via SSH |
2FA: add header X-Gitea-OTP: 123456 with Basic Auth.
Token Scopes
"scopes": ["all"] or fine-grained: ["repo", "write:repository", "read:user", "read:organization"]. Create via UI or POST /api/v1/users/{username}/tokens.