# Codeberg User API

**Canonical:** https://apis.io/apis/codeberg/codeberg-user-api/  
**Provider:** Codeberg — https://apis.io/providers/codeberg/  
**Base URL:** https://codeberg.org/api/v1  
**Documentation:** https://codeberg.org/api/swagger

Codeberg User API is one of 10 APIs that [Codeberg](https://apis.io/providers/codeberg/) 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, API documentation, and an API reference.

The user API from Codeberg — 54 operation(s) for user.

## Operations (60 of 80)

| Method | Path | Summary |
|---|---|---|
| GET | `/user` | Get the authenticated user |
| GET | `/user/actions/runners` | Get the user's runners |
| POST | `/user/actions/runners` | Register a new user-level runner |
| GET | `/user/actions/runners/jobs` | Search for user's action jobs according filter conditions |
| GET | `/user/actions/runners/registration-token` | Get the user's runner registration token |
| GET | `/user/actions/runners/{runner_id}` | Get a particular runner that belongs to the user |
| DELETE | `/user/actions/runners/{runner_id}` | Delete a particular user-level runner |
| 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 |
| POST | `/user/activitypub/follow` | Follow a remote activitypub account |
| 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 of the current user |
| DELETE | `/user/avatar` | Delete avatar of the current user. It will be replaced by a default one |
| PUT | `/user/block/{username}` | Blocks a user from the doer |
| GET | `/user/emails` | List all email addresses of the current user |
| POST | `/user/emails` | Add an email addresses to the current user's account |
| DELETE | `/user/emails` | Delete email addresses from the current user's account |
| 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` | Add a GPG public key to current user's account |
| GET | `/user/gpg_keys/{id}` | Get a GPG key |
| DELETE | `/user/gpg_keys/{id}` | Remove a GPG public key from current user's account |
| 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/list_blocked` | List the authenticated user's blocked users |
| GET | `/user/quota` | Get quota information for the authenticated user |
| GET | `/user/quota/artifacts` | List the artifacts affecting the authenticated user's quota |
| GET | `/user/quota/attachments` | List the attachments affecting the authenticated user's quota |
| GET | `/user/quota/check` | Check if the authenticated user is over quota for a given subject |
| GET | `/user/quota/packages` | List the packages affecting the authenticated user's quota |
| GET | `/user/repos` | List the repos that the authenticated user owns |
| POST | `/user/repos` | Create a repository |
| GET | `/user/settings` | Get current user's account settings |
| PATCH | `/user/settings` | Update settings in current user's account |
| 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 |

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

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/codeberg/refs/heads/main/openapi/codeberg-user-api-openapi.yml
- **Documentation** — https://docs.codeberg.org/advanced/api-usage/
- **APIReference** — https://codeberg.org/api/swagger
- **PostmanCollection** — https://raw.githubusercontent.com/api-evangelist/codeberg/refs/heads/main/collections/codeberg.postman_collection.json
- **OpenCollection** — https://raw.githubusercontent.com/api-evangelist/codeberg/refs/heads/main/collections/codeberg.opencollection.json

## Other Codeberg APIs (9)

- [Codeberg Miscellaneous API](https://apis.io/apis/codeberg/codeberg-miscellaneous-api/)
- [Codeberg Activitypub API](https://apis.io/apis/codeberg/codeberg-activitypub-api/)
- [Codeberg Admin API](https://apis.io/apis/codeberg/codeberg-admin-api/)
- [Codeberg Issue API](https://apis.io/apis/codeberg/codeberg-issue-api/)
- [Codeberg Notification API](https://apis.io/apis/codeberg/codeberg-notification-api/)
- [Codeberg Organization API](https://apis.io/apis/codeberg/codeberg-organization-api/)
- [Codeberg Package API](https://apis.io/apis/codeberg/codeberg-package-api/)
- [Codeberg Repository API](https://apis.io/apis/codeberg/codeberg-repository-api/)
- [Codeberg Settings API](https://apis.io/apis/codeberg/codeberg-settings-api/)

## Tags

User

---

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