# Gitea admin API

**Canonical:** https://apis.io/apis/gitea/gitea-admin-api/  
**Provider:** Gitea — https://apis.io/providers/gitea/  
**Base URL:** https://gitea.com/api/v1  
**Documentation:** https://docs.gitea.com/api/

Gitea admin API is one of 13 APIs that [Gitea](https://apis.io/providers/gitea/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 32 JSON Schema definitions. Tagged areas include Admin. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, code examples, and 32 JSON Schemas.

The admin API from Gitea — 22 operation(s) for admin.

## Operations (32)

| Method | Path | Summary |
|---|---|---|
| GET | `/admin/actions/jobs` | Lists all jobs |
| GET | `/admin/actions/runners` | Get all runners |
| POST | `/admin/actions/runners/registration-token` | Get a global actions runner registration token |
| GET | `/admin/actions/runners/{runner_id}` | Get a global runner |
| DELETE | `/admin/actions/runners/{runner_id}` | Delete a global runner |
| PATCH | `/admin/actions/runners/{runner_id}` | Update a global runner |
| GET | `/admin/actions/runs` | Lists all runs |
| GET | `/admin/cron` | List cron tasks |
| POST | `/admin/cron/{task}` | Run cron task |
| GET | `/admin/emails` | List all emails |
| GET | `/admin/emails/search` | Search all emails |
| GET | `/admin/hooks` | List system's webhooks |
| POST | `/admin/hooks` | Create a hook |
| GET | `/admin/hooks/{id}` | Get a hook |
| DELETE | `/admin/hooks/{id}` | Delete a hook |
| PATCH | `/admin/hooks/{id}` | Update a hook |
| GET | `/admin/orgs` | List all organizations |
| GET | `/admin/unadopted` | List unadopted repositories |
| POST | `/admin/unadopted/{owner}/{repo}` | Adopt unadopted files as a repository |
| DELETE | `/admin/unadopted/{owner}/{repo}` | Delete unadopted files |
| GET | `/admin/users` | Search users according filter conditions |
| POST | `/admin/users` | Create a user |
| DELETE | `/admin/users/{username}` | Delete a user |
| PATCH | `/admin/users/{username}` | Edit an existing user |
| GET | `/admin/users/{username}/badges` | List a user's badges |
| POST | `/admin/users/{username}/badges` | Add a badge to a user |
| DELETE | `/admin/users/{username}/badges` | Remove a badge from a user |
| POST | `/admin/users/{username}/keys` | Add a public key on behalf of a user |
| DELETE | `/admin/users/{username}/keys/{id}` | Delete a user's public key |
| POST | `/admin/users/{username}/orgs` | Create an organization |
| POST | `/admin/users/{username}/rename` | Rename a user |
| POST | `/admin/users/{username}/repos` | Create a repository on behalf of a user |

## Machine-readable artifacts (61)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/openapi/gitea-admin-api-openapi.yml
- **Documentation** — https://docs.gitea.com/api/
- **APIReference** — https://docs.gitea.com/api/1.26/
- **Swagger** — https://demo.gitea.com/api/swagger
- **GettingStarted** — https://docs.gitea.com/development/api-usage
- **Authentication** — https://docs.gitea.com/development/oauth2-provider
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-repository-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-issue-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-pullrequest-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-branch-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-commit-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-release-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-hook-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-organization-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-team-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-user-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-notificationthread-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-package-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-label-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-milestone-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-tag-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-comment-schema.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-repository-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-issue-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-pullrequest-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-branch-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-commit-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-release-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-hook-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-organization-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-team-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-user-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-notificationthread-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-package-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-label-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-milestone-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-tag-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-comment-structure.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-repo-get-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-repo-update-example.json
- …and 21 more, listed in full on the page.

## Other Gitea APIs (12)

- [Gitea Actions API](https://apis.io/apis/gitea/gitea-actions-api/)
- [Gitea Package Registry](https://apis.io/apis/gitea/gitea-package-registry/)
- [Gitea Webhooks](https://apis.io/apis/gitea/gitea-webhooks/)
- [Gitea Cloud Management API](https://apis.io/apis/gitea/gitea-cloud-management-api/)
- [Gitea issue API](https://apis.io/apis/gitea/gitea-issue-api/)
- [Gitea miscellaneous API](https://apis.io/apis/gitea/gitea-miscellaneous-api/)
- [Gitea notification API](https://apis.io/apis/gitea/gitea-notification-api/)
- [Gitea organization API](https://apis.io/apis/gitea/gitea-organization-api/)
- [Gitea package API](https://apis.io/apis/gitea/gitea-package-api/)
- [Gitea repository API](https://apis.io/apis/gitea/gitea-repository-api/)
- [Gitea settings API](https://apis.io/apis/gitea/gitea-settings-api/)
- [Gitea user API](https://apis.io/apis/gitea/gitea-user-api/)

## Tags

Admin

---

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