Moko Consulting

Open-source software for Joomla, Gitea, and web platforms. Home of MokoSuite, MokoGitea, and MokoCLI.

Tennessee
api/mokogitea-api.-

MokoGitea API

Custom API extensions in MokoGitea beyond upstream Gitea.

Base URL

https://git.mokoconsulting.tech/api/v1/

Authentication

Authorization: token {gitea_api_token}

Standard Gitea Endpoints

MokoGitea inherits all upstream Gitea v1 API endpoints. See Gitea API docs.

Common operations:

GET    /api/v1/repos/{owner}/{repo}                    # Get repo
GET    /api/v1/repos/{owner}/{repo}/issues             # List issues
POST   /api/v1/repos/{owner}/{repo}/issues             # Create issue
GET    /api/v1/repos/{owner}/{repo}/releases           # List releases
POST   /api/v1/repos/{owner}/{repo}/releases           # Create release
GET    /api/v1/repos/{owner}/{repo}/wiki/pages         # List wiki pages
PATCH  /api/v1/repos/{owner}/{repo}/wiki/page/{name}   # Update wiki page

MokoGitea Custom Endpoints

Manifest

GET  /api/v1/repos/{owner}/{repo}/manifest
PUT  /api/v1/repos/{owner}/{repo}/manifest

Read or update the .mokogitea/manifest.xml file:

{
  "platform": "joomla",
  "element": "pkg_mokosuitebackup",
  "org": "MokoConsulting",
  "build": {
    "command": "make build",
    "output": "dist/"
  }
}

Organization Custom Fields

GET    /api/v1/orgs/{org}/custom-fields
POST   /api/v1/orgs/{org}/custom-fields
DELETE /api/v1/orgs/{org}/custom-fields/{id}

Issue Custom Fields

GET  /api/v1/repos/{owner}/{repo}/issues/{index}/custom-fields
PUT  /api/v1/repos/{owner}/{repo}/issues/{index}/custom-fields

Issue Priorities

GET  /api/v1/orgs/{org}/issue-priorities

Issue Statuses

GET  /api/v1/orgs/{org}/issue-statuses

Mirror Management

GET    /api/v1/repos/{owner}/{repo}/mirrors              # List push mirrors
POST   /api/v1/repos/{owner}/{repo}/mirrors              # Create push mirror
DELETE /api/v1/repos/{owner}/{repo}/mirrors/{id}          # Delete mirror
POST   /api/v1/repos/{owner}/{repo}/mirrors/{id}/sync    # Trigger sync

Joomla Update Server

For repos with platform: joomla in their manifest:

GET /api/v1/repos/{owner}/{repo}/joomla/updates.xml

Returns auto-generated Joomla update server XML from release assets.

Raw API Requests

For endpoints not covered by MCP tools, use the raw request tool:

mcp__mokogitea_api__gitea_api_request
  method: GET|POST|PATCH|PUT|DELETE
  endpoint: /repos/{owner}/{repo}/...
  body: {...}   # optional

Rate Limiting

MokoGitea does not enforce rate limiting for authenticated requests from trusted API tokens. Unauthenticated requests are limited to 20/minute.