# Gogs Users API

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

Gogs Users 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 User. The published artifact set on APIs.io includes an OpenAPI specification.

Search users, manage access tokens, emails, followers, and public keys

## Operations (21)

| Method | Path | Summary |
|---|---|---|
| GET | `/users/search` | Search for users |
| GET | `/users/{username}` | Get a single user |
| GET | `/user` | Get the authenticated user |
| GET | `/users/{username}/tokens` | List access tokens |
| POST | `/users/{username}/tokens` | Create an access token |
| GET | `/user/emails` | List email addresses |
| POST | `/user/emails` | Add email addresses |
| DELETE | `/user/emails` | Delete email addresses |
| GET | `/users/{username}/followers` | List followers of a user |
| GET | `/user/followers` | List your followers |
| GET | `/users/{username}/following` | List users followed by a user |
| GET | `/user/following` | List who you are following |
| GET | `/user/following/{target}` | Check if you follow a user |
| PUT | `/user/following/{target}` | Follow a user |
| DELETE | `/user/following/{target}` | Unfollow a user |
| GET | `/users/{username}/following/{target}` | Check if a user follows another |
| GET | `/users/{username}/keys` | List public keys for a user |
| GET | `/user/keys/{id}` | Get a single public key |
| DELETE | `/user/keys/{id}` | Delete a public key |
| GET | `/user/keys` | List your public keys |
| POST | `/user/keys` | Create a public key |

## Machine-readable artifacts (1)

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

## Other Gogs APIs (9)

- [Gogs API](https://apis.io/apis/gogs/gogs-api/)
- [Gogs Administration API](https://apis.io/apis/gogs/gogs-administration-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 Webhooks API](https://apis.io/apis/gogs/gogs-webhooks-api/)

## Tags

User

---

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