Action domain

achievement

Every action this domain exposes through gitlab_execute_action, from the gitlab://tools manifest. Each entry folds out to its full upstream description and required parameters.

12 · actions3 · destructive4 · read-only

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 counts 868 operations on Community Edition and up to 1,094 on GitLab.com's top tier, while this deployment publishes 768 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.

Each entry also says what a GitLab fine-grained personal access token needs to run it, as GitLab 19.4.1 declares it: every permission of one line, at one of the boundaries named. Where there are alternatives, any one is enough.

Back to the server card

1. 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)

   Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token

2. 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)

   Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token

3. achievement.delete

   Achievement Deletedestructive

   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)

   Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token

4. achievement.list

   Achievement Listread-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)

   Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token

5. achievement.recipients

   Achievement Recipientsread-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)

   Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token

6. achievement.revoke

   Achievement Revokedestructive

   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)

   Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token

7. achievement.unique_users

   Achievement Unique Usersread-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)

   Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token

8. 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)

   Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token

9. achievement.user_achievement_delete

   Achievement User Achievement Deletedestructive

   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)

   Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token

10. 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)

    Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token

11. 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)

    Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token

12. achievement.user_list

    Achievement User Listread-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)

    Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token