# Gitea user API

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

Gitea user 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 User. 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 user API from Gitea — 48 operation(s) for user.

## Operations (60 of 76)

| Method | Path | Summary |
|---|---|---|
| GET | `/user` | Get the authenticated user |
| GET | `/user/actions/jobs` | Get workflow jobs |
| GET | `/user/actions/runners` | Get user-level runners |
| POST | `/user/actions/runners/registration-token` | Get a user's actions runner registration token |
| GET | `/user/actions/runners/{runner_id}` | Get a user-level runner |
| DELETE | `/user/actions/runners/{runner_id}` | Delete a user-level runner |
| PATCH | `/user/actions/runners/{runner_id}` | Update a user-level runner |
| GET | `/user/actions/runs` | Get workflow runs |
| PUT | `/user/actions/secrets/{secretname}` | Create or Update a secret value in a user scope |
| DELETE | `/user/actions/secrets/{secretname}` | Delete a secret in a user scope |
| GET | `/user/actions/variables` | Get the user-level list of variables which is created by current doer |
| GET | `/user/actions/variables/{variablename}` | Get a user-level variable which is created by current doer |
| PUT | `/user/actions/variables/{variablename}` | Update a user-level variable which is created by current doer |
| POST | `/user/actions/variables/{variablename}` | Create a user-level variable |
| DELETE | `/user/actions/variables/{variablename}` | Delete a user-level variable which is created by current doer |
| GET | `/user/applications/oauth2` | List the authenticated user's oauth2 applications |
| POST | `/user/applications/oauth2` | creates a new OAuth2 application |
| GET | `/user/applications/oauth2/{id}` | get an OAuth2 Application |
| DELETE | `/user/applications/oauth2/{id}` | delete an OAuth2 Application |
| PATCH | `/user/applications/oauth2/{id}` | update an OAuth2 Application, this includes regenerating the client secret |
| POST | `/user/avatar` | Update Avatar |
| DELETE | `/user/avatar` | Delete Avatar |
| GET | `/user/blocks` | List users blocked by the authenticated user |
| GET | `/user/blocks/{username}` | Check if a user is blocked by the authenticated user |
| PUT | `/user/blocks/{username}` | Block a user |
| DELETE | `/user/blocks/{username}` | Unblock a user |
| GET | `/user/emails` | List the authenticated user's email addresses |
| POST | `/user/emails` | Add email addresses |
| DELETE | `/user/emails` | Delete email addresses |
| GET | `/user/followers` | List the authenticated user's followers |
| GET | `/user/following` | List the users that the authenticated user is following |
| GET | `/user/following/{username}` | Check whether a user is followed by the authenticated user |
| PUT | `/user/following/{username}` | Follow a user |
| DELETE | `/user/following/{username}` | Unfollow a user |
| GET | `/user/gpg_key_token` | Get a Token to verify |
| POST | `/user/gpg_key_verify` | Verify a GPG key |
| GET | `/user/gpg_keys` | List the authenticated user's GPG keys |
| POST | `/user/gpg_keys` | Create a GPG key |
| GET | `/user/gpg_keys/{id}` | Get a GPG key |
| DELETE | `/user/gpg_keys/{id}` | Remove a GPG key |
| GET | `/user/hooks` | List the authenticated user's webhooks |
| POST | `/user/hooks` | Create a hook |
| GET | `/user/hooks/{id}` | Get a hook |
| DELETE | `/user/hooks/{id}` | Delete a hook |
| PATCH | `/user/hooks/{id}` | Update a hook |
| GET | `/user/keys` | List the authenticated user's public keys |
| POST | `/user/keys` | Create a public key |
| GET | `/user/keys/{id}` | Get a public key |
| DELETE | `/user/keys/{id}` | Delete a public key |
| GET | `/user/repos` | List the repos that the authenticated user owns |
| POST | `/user/repos` | Create a repository |
| GET | `/user/settings` | Get user settings |
| PATCH | `/user/settings` | Update user settings |
| GET | `/user/starred` | The repos that the authenticated user has starred |
| GET | `/user/starred/{owner}/{repo}` | Whether the authenticated is starring the repo |
| PUT | `/user/starred/{owner}/{repo}` | Star the given repo |
| DELETE | `/user/starred/{owner}/{repo}` | Unstar the given repo |
| GET | `/user/stopwatches` | Get list of all existing stopwatches |
| GET | `/user/subscriptions` | List repositories watched by the authenticated user |
| GET | `/user/teams` | List all the teams a user belongs to |

…and 16 more operations. They are listed in full on the page.

## Machine-readable artifacts (61)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/openapi/gitea-user-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 admin API](https://apis.io/apis/gitea/gitea-admin-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/)

## Tags

User

---

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