Gestion des groupes - Devin Docs

Cette documentation concerne les déploiements fédéraux de Devin. Retour à la documentation Devin

Gérez les groupes par programmation : créez, lisez, mettez à jour et supprimez des groupes, gérez leurs adhésions et configurez leur disponibilité des modèles ainsi que leurs plafonds d’ACU. Ces endpoints sont disponibles uniquement sur les déploiements fédéraux multi-tenant. Tous les endpoints utilisent des requêtes JSON POST. Chaque corps de requête inclut service_key ; consultez la vue d’ensemble de l’API pour l’authentification, le périmètre, la pagination et les erreurs. Les endpoints de lecture nécessitent Teams Read-Only ; les endpoints d’écriture nécessitent Teams Update. Ces gestionnaires sont réservés aux déploiements self-hosted multi-tenant, mais n’appliquent pas la vérification distincte du niveau d’accès à l’analyse utilisée par /Analytics. L’objet groupe renvoyé par les endpoints de lecture et d’écriture :

Champ	Description
`group_id`	L’ID du groupe.
`name`	Le nom du groupe.
`member_count`	Nombre de Members actuels.
`cascade_model_uids`	UID des modèles autorisés pour Cascade. Une liste vide signifie que le groupe n’impose aucune restriction pour Cascade.
`command_model_uids`	UID des modèles autorisés pour Command. Une liste vide signifie que le groupe n’impose aucune restriction pour Command.
`configured_cycle_acu_limit`	Plafond d’ACU par Member configuré pour le groupe. Omis lorsqu’aucun plafond n’est configuré. Toujours positif lorsqu’il est présent.
`effective_cycle_acu_limit`	Plafond effectivement appliqué au groupe après prise en compte des limites de la Team. Omis lorsqu’aucune limite ne s’applique.

Lister les groupes

POST /api/v1/ListGroups

Liste les groupes visibles par la clé de service. Les clés limitées au périmètre de la Team répertorient tous les groupes de la Team ; les clés limitées au périmètre d’un groupe répertorient uniquement le groupe qui leur est assigné. Nécessite Teams Read-Only. Prend en charge page_size / page_token.

curl -X POST https://<your-server>/api/v1/ListGroups \
  -H "Content-Type: application/json" \
  -d '{"service_key": "your_service_key"}'

{
  "groups": [
    {"groupId": "group_a", "name": "Engineering", "memberCount": 24},
    {"groupId": "group_b", "name": "Data Science", "memberCount": 9}
  ],
  "nextPageToken": ""
}

Récupérer un groupe

POST /api/v1/GetGroup

Récupère un groupe, y compris ses listes d’autorisation de modèles, ainsi que son plafond d’ACU configuré et effectif. Nécessite l’autorisation Teams Read-Only. Les groupes inexistants, appartenant à une autre Team ou hors périmètre renvoient not_found.

curl -X POST https://<your-server>/api/v1/GetGroup \
  -H "Content-Type: application/json" \
  -d '{"service_key": "your_service_key", "group_id": "group_a"}'

{
  "group": {
    "groupId": "group_a",
    "name": "Engineering",
    "memberCount": 24,
    "cascadeModelUids": ["model-uid-1", "model-uid-2"],
    "commandModelUids": [],
    "configuredCycleAcuLimit": 50,
    "effectiveCycleAcuLimit": 50
  }
}

Créer un groupe

POST /api/v1/CreateGroup

Crée un groupe avec le name spécifié dans la Team effective. Nécessite l’autorisation Teams Update. Les clés limitées à un groupe ne peuvent pas créer de groupes.

curl -X POST https://<your-server>/api/v1/CreateGroup \
  -H "Content-Type: application/json" \
  -d '{"service_key": "your_service_key", "name": "Engineering"}'

La réponse contient l’objet group nouvellement créé.

Mettre à jour le groupe

POST /api/v1/UpdateGroup

Met à jour un groupe de manière atomique. Seuls les champs présents dans la requête sont modifiés ; les champs omis restent inchangés. Une requête ne contenant aucun champ à modifier renvoie invalid_argument. Nécessite l’autorisation Teams Update.

string

requis

Le groupe à mettre à jour.

string

Nouveau nom du groupe.

object

{"model_uids": [...]} — remplace la liste d’autorisation des modèles Cascade du groupe. Transmettre une liste vide supprime la restriction Cascade du groupe. Consultez Model Provisioning pour savoir comment les listes d’autorisation des groupes se combinent.

object

{"model_uids": [...]} — remplace la liste d’autorisation des modèles Command du groupe. Transmettre une liste vide supprime la restriction Command du groupe.

number

Définit le plafond d’ACU par membre du groupe et par cycle de facturation. Doit être positif. Ne peut pas être utilisé avec clear_cycle_acu_limit.

boolean

Supprime le plafond d’ACU du groupe et rétablit le comportement de la Team ou le comportement par défaut. Dans cette API à clé de service, set_cycle_acu_limit doit être fini et positif ; utilisez cette opération de suppression explicite pour retirer la dérogation du groupe. Le contrôle de la limite d’ACU du groupe dans le portail accepte cycle_acu_limit: 0 comme demande de suppression.

curl -X POST https://<your-server>/api/v1/UpdateGroup \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "your_service_key",
    "group_id": "group_a",
    "cascade_models": {"model_uids": ["model-uid-1", "model-uid-2"]},
    "set_cycle_acu_limit": 50
  }'

La réponse contient l’objet group mis à jour.

Supprimer le groupe

POST /api/v1/DeleteGroup

Supprime un groupe à l’aide de group_id. La suppression d’un groupe déjà absent du périmètre autorisé de la key réussit sans effet. Nécessite Teams Update.

curl -X POST https://<your-server>/api/v1/DeleteGroup \
  -H "Content-Type: application/json" \
  -d '{"service_key": "your_service_key", "group_id": "group_a"}'

Lister les membres d’un groupe

POST /api/v1/ListGroupMembers

Répertorie les membres actuels d’un groupe. Nécessite l’autorisation Teams Read-Only. Prend en charge page_size / page_token.

curl -X POST https://<your-server>/api/v1/ListGroupMembers \
  -H "Content-Type: application/json" \
  -d '{"service_key": "your_service_key", "group_id": "group_a"}'

{
  "members": [
    {"userId": "user_abc", "email": "dev@agency.gov"}
  ],
  "nextPageToken": ""
}

Ajouter des membres à un groupe

POST /api/v1/AddGroupMembers

Ajoute les utilisateurs de la Team actuelle à un groupe par e-mail (user_emails, de 1 à 1 000 entrées). Nécessite l’autorisation Teams Update.

Idempotent : l’ajout d’un Member déjà existant réussit sans effet.
Les e-mails sont supprimés des espaces superflus et dédupliqués sans tenir compte de la casse.
Tout ou rien : si une adresse e-mail est inconnue ou appartient à une autre Team, l’intégralité de la requête est rejetée et aucune donnée n’est écrite.

curl -X POST https://<your-server>/api/v1/AddGroupMembers \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "your_service_key",
    "group_id": "group_a",
    "user_emails": ["dev@agency.gov", "lead@agency.gov"]
  }'

Supprimer des membres d’un groupe

POST /api/v1/RemoveGroupMembers

Supprime des utilisateurs d’un groupe par adresse e-mail (user_emails, de 1 à 1 000 entrées). Nécessite l’autorisation Teams Update. La validation est tout ou rien, comme pour Add group members ; supprimer un utilisateur valide qui n’est pas Member est une opération réussie sans effet.

curl -X POST https://<your-server>/api/v1/RemoveGroupMembers \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "your_service_key",
    "group_id": "group_a",
    "user_emails": ["dev@agency.gov"]
  }'

​Lister les groupes

​Récupérer un groupe

​Créer un groupe

​Mettre à jour le groupe

​Supprimer le groupe

​Lister les membres d’un groupe

​Ajouter des membres à un groupe

​Supprimer des membres d’un groupe

Lister les groupes

Récupérer un groupe

Créer un groupe

Mettre à jour le groupe

Supprimer le groupe

Lister les membres d’un groupe

Ajouter des membres à un groupe

Supprimer des membres d’un groupe