Dominio de acciones

achievement

Todas las acciones que este dominio expone vía gitlab_execute_action, del manifiesto gitlab://tools. Cada entrada se despliega a su descripción completa y sus parámetros obligatorios.

12 · acciones3 · destructivas4 · solo lectura

Contado con un token Free contra gitlab.com, que es el único host con el que habla este endpoint: para usarlo contra una instancia self-managed, levanta tú el servidor — su documentación lo cubre. El catálogo depende del token que pregunta, así que el recuento se mueve con su tier y con sus permisos: los tiers superiores exponen más acciones, y los dominios de administración solo aparecen a tokens autorizados a usarlos. Por eso las cifras difieren en otros sitios: el proyecto upstream cuenta 868 operaciones en Community Edition y hasta 1.094 en el tier más alto de GitLab.com, mientras que este despliegue publica 768 porque es solo-OAuth y actúa con tu token, así que los dominios de administración que una cuenta sin admin no puede llamar no aparecen nunca. Las tres describen el mismo catálogo, contado desde tres sitios distintos.

Cada entrada dice también qué necesita un token de acceso personal fine-grained de GitLab para ejecutarla, tal como lo declara GitLab 19.4.1: todos los permisos de una línea, en uno de los ámbitos indicados. Cuando hay alternativas, basta con cualquiera.

Volver a la ficha del servidor

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.

   Parámetros obligatorios: achievement_id (integer), user_id (integer)

   Token fine-grained: ninguno puede ejecutarla en esta versión de GitLab, que no declara nada para ella; usa un token clásico

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.

   Parámetros obligatorios: name (string), namespace_id (integer)

   Token fine-grained: ninguno puede ejecutarla en esta versión de GitLab, que no declara nada para ella; usa un token clásico

3. achievement.delete

   Achievement Deletedestructiva

   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.

   Parámetros obligatorios: achievement_id (integer)

   Token fine-grained: ninguno puede ejecutarla en esta versión de GitLab, que no declara nada para ella; usa un token clásico

4. achievement.list

   Achievement Listsolo lectura

   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.

   Parámetros obligatorios: full_path (string)

   Token fine-grained: ninguno puede ejecutarla en esta versión de GitLab, que no declara nada para ella; usa un token clásico

5. achievement.recipients

   Achievement Recipientssolo lectura

   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.

   Parámetros obligatorios: achievement_id (integer), full_path (string)

   Token fine-grained: ninguno puede ejecutarla en esta versión de GitLab, que no declara nada para ella; usa un token clásico

6. achievement.revoke

   Achievement Revokedestructiva

   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.

   Parámetros obligatorios: user_achievement_id (integer)

   Token fine-grained: ninguno puede ejecutarla en esta versión de GitLab, que no declara nada para ella; usa un token clásico

7. achievement.unique_users

   Achievement Unique Userssolo lectura

   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.

   Parámetros obligatorios: achievement_id (integer), full_path (string)

   Token fine-grained: ninguno puede ejecutarla en esta versión de GitLab, que no declara nada para ella; usa un token clásico

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.

   Parámetros obligatorios: achievement_id (integer)

   Token fine-grained: ninguno puede ejecutarla en esta versión de GitLab, que no declara nada para ella; usa un token clásico

9. achievement.user_achievement_delete

   Achievement User Achievement Deletedestructiva

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

   Parámetros obligatorios: user_achievement_id (integer)

   Token fine-grained: ninguno puede ejecutarla en esta versión de GitLab, que no declara nada para ella; usa un token clásico

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.

    Parámetros obligatorios: user_achievement_ids (array)

    Token fine-grained: ninguno puede ejecutarla en esta versión de GitLab, que no declara nada para ella; usa un token clásico

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.

    Parámetros obligatorios: user_achievement_id (integer)

    Token fine-grained: ninguno puede ejecutarla en esta versión de GitLab, que no declara nada para ella; usa un token clásico

12. achievement.user_list

    Achievement User Listsolo lectura

    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.

    Parámetros obligatorios: username (string)

    Token fine-grained: ninguno puede ejecutarla en esta versión de GitLab, que no declara nada para ella; usa un token clásico