# achievement — gitlab

> 12 actions
> This page as plain markdown. Index: https://mcp.jmrp.io/llms.txt

Canonical: https://mcp.jmrp.io/servers/gitlab/actions/achievement/
Language: en
Alternate: https://mcp.jmrp.io/es/servers/gitlab/actions/achievement/index.md
Updated: 2026-09-11T09:56:41+02:00
License: https://mcp.jmrp.io/license/

Counted with a Free-tier token against gitlab.com, which is the only host this endpoint talks to: to use it against a self-managed instance, run the server yourself — its documentation covers that. The catalog is scoped to the token that asks, so the count moves with both its tier and its permissions: higher tiers expose more actions, and administration domains only appear to tokens allowed to use them. That is why the figures differ elsewhere: the upstream project catalogues 1,006 actions across 162 domains, and 851 on the Free/CE surface, while this deployment publishes 747 because it is OAuth-only and acts with your token, so the administration domains a non-admin account cannot call never appear. All three describe the same catalog, counted from three vantage points.

## Actions

### `achievement.award` — Achievement Award

Award an achievement to a user. Returns: the new award with its own id, achievement_id, user_id, awarded_by_user_id, award_message, priority, show_on_profile, and timestamps. See also: achievement.revoke, achievement.recipients, achievement.user_list.

**Required parameters:** `achievement_id (integer)`, `user_id (integer)`

### `achievement.create` — Achievement Create

Define a new achievement in a group or project namespace. Creating one awards it to nobody. Returns: the created achievement with id, namespace_id, name, description, avatar_url, and timestamps. See also: achievement.award, achievement.list, achievement.update.

**Required parameters:** `name (string)`, `namespace_id (integer)`

### `achievement.delete` — Achievement Delete

_destructive_

Delete an achievement definition and every award made from it. Returns: deletion confirmation plus the achievement as it looked when removed. See also: achievement.revoke, achievement.list, achievement.create.

**Required parameters:** `achievement_id (integer)`

### `achievement.list` — Achievement List

_read-only_

List the achievements a group or project namespace defines, with cursor pagination. Returns: each achievement with id, namespace_id, name, description, avatar_url, and timestamps, plus pagination cursors. See also: achievement.recipients, achievement.create, achievement.award.

**Required parameters:** `full_path (string)`

### `achievement.recipients` — Achievement Recipients

_read-only_

List every award of one achievement, revoked awards and repeat awards included, with cursor pagination. Returns: each award with its own id, achievement_id, user_id, award_message, priority, show_on_profile, and revocation stamps, plus pagination cursors. See also: achievement.unique_users, achievement.user_list, achievement.revoke.

**Required parameters:** `achievement_id (integer)`, `full_path (string)`

### `achievement.revoke` — Achievement Revoke

_destructive_

Revoke one award while keeping its record, which is then stamped with revoked_at and revoked_by_user_id. Returns: confirmation plus the revoked award. See also: achievement.user_achievement_delete, achievement.award, achievement.recipients.

**Required parameters:** `user_achievement_id (integer)`

### `achievement.unique_users` — Achievement Unique Users

_read-only_

List the distinct users who hold one achievement, deduplicated across repeat awards, with cursor pagination. Returns: each user with id, username, name, state, avatar_url, and web_url, plus pagination cursors. See also: achievement.recipients, achievement.user_list, achievement.list.

**Required parameters:** `achievement_id (integer)`, `full_path (string)`

### `achievement.update` — Achievement Update

Change an existing achievement's name, description, or avatar. Omitted fields keep their current value. Returns: the updated achievement with id, namespace_id, name, description, avatar_url, and timestamps. See also: achievement.list, achievement.create, achievement.delete.

**Required parameters:** `achievement_id (integer)`

### `achievement.user_achievement_delete` — Achievement User Achievement Delete

_destructive_

Erase one award record outright, keeping no revocation history. Returns: confirmation plus the deleted award. See also: achievement.revoke, achievement.user_list, achievement.delete.

**Required parameters:** `user_achievement_id (integer)`

### `achievement.user_achievement_reorder` — Achievement User Achievement Reorder

Set the display order of one user's awards, highest priority first. Returns: confirmation plus every award in its new order with the assigned priority. See also: achievement.user_list, achievement.user_achievement_update, achievement.award.

**Required parameters:** `user_achievement_ids (array)`

### `achievement.user_achievement_update` — Achievement User Achievement Update

Change one award, which today means its show_on_profile visibility. Returns: the updated award with id, achievement_id, user_id, priority, show_on_profile, and timestamps. See also: achievement.user_list, achievement.user_achievement_reorder, achievement.update.

**Required parameters:** `user_achievement_id (integer)`

### `achievement.user_list` — Achievement User List

_read-only_

List the awards one user holds, by username, with cursor pagination. Returns: each award with id, achievement_id, user_id, priority, show_on_profile, award_message, and revocation stamps, plus pagination cursors. See also: achievement.recipients, achievement.user_achievement_reorder, achievement.award.

**Required parameters:** `username (string)`