# Gogs Administration API

**Canonical:** https://apis.io/apis/gogs/gogs-administration-api/  
**Provider:** Gogs — https://apis.io/providers/gogs/  
**Base URL:** https://gogs.example.com/api/v1  
**Documentation:** https://gogs.io/api-reference/introduction

Gogs Administration API is one of 10 APIs that [Gogs](https://apis.io/providers/gogs/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Administration. The published artifact set on APIs.io includes an OpenAPI specification.

Site administration endpoints (requires admin privileges)

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| POST | `/admin/users` | Create a new user |
| PATCH | `/admin/users/{username}` | Edit an existing user |
| DELETE | `/admin/users/{username}` | Delete a user |
| POST | `/admin/users/{username}/keys` | Create a public key for a user |
| POST | `/admin/users/{username}/repos` | Create a repository for a user |
| POST | `/admin/users/{username}/orgs` | Create an organization |
| POST | `/admin/orgs/{orgname}/teams` | Create a team |
| GET | `/admin/teams/{teamid}/members` | List all members of a team |
| PUT | `/admin/teams/{teamid}/members/{username}` | Add team membership |
| DELETE | `/admin/teams/{teamid}/members/{username}` | Remove team membership |
| PUT | `/admin/teams/{teamid}/repos/{reponame}` | Add or update team repository |
| DELETE | `/admin/teams/{teamid}/repos/{reponame}` | Remove team repository |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gogs/refs/heads/main/openapi/gogs-administration-api-openapi.yml

## Other Gogs APIs (9)

- [Gogs API](https://apis.io/apis/gogs/gogs-api/)
- [Gogs Collaborators and Deploy Keys API](https://apis.io/apis/gogs/gogs-collaborators-and-deploy-keys-api/)
- [Gogs Issues API](https://apis.io/apis/gogs/gogs-issues-api/)
- [Gogs Miscellaneous API](https://apis.io/apis/gogs/gogs-miscellaneous-api/)
- [Gogs Organizations API](https://apis.io/apis/gogs/gogs-organizations-api/)
- [Gogs Releases API](https://apis.io/apis/gogs/gogs-releases-api/)
- [Gogs Repositories API](https://apis.io/apis/gogs/gogs-repositories-api/)
- [Gogs Users API](https://apis.io/apis/gogs/gogs-users-api/)
- [Gogs Webhooks API](https://apis.io/apis/gogs/gogs-webhooks-api/)

## Tags

Administration

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gogs/gogs-administration-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gogs/.