Aller au contenu principal

API Groupes

Gérez les groupes d'utilisateurs pour le contrôle d'accès et l'organisation.

Créer un Groupe​

Crée un nouveau groupe dans un espace de travail.

Requête

curl -X POST https://api.syauth.com/e/v1/developer/groups/ \
  -H "X-Developer-Token: syat_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Beta Testers",
    "description": "Users with access to beta features",
    "workspace": "78047707-5f8f-472b-a065-3d3dc48ba80a"
  }'

Réponse

{
  "id": "4e267feb-4409-4185-97cc-b34003aa1044",
  "name": "Beta Testers",
  "description": "Users with access to beta features",
  "workspace_id": "78047707-5f8f-472b-a065-3d3dc48ba80a",
  "member_count": 0,
  "created_at": "2026-01-07T10:15:00Z"
}

Lister les Groupes​

Requête

curl -X GET https://api.syauth.com/e/v1/developer/groups/ \
  -H "X-Developer-Token: syat_..."

Réponse

[
  {
    "id": "4e267feb-4409-4185-97cc-b34003aa1044",
    "name": "Admin Group",
    "alias": "admins",
    "workspace_id": "78047707-5f8f-472b-a065-3d3dc48ba80a",
    "member_count": 3,
    "created_at": "2026-01-01T22:29:13.356Z"
  }
]

Obtenir les Détails d'un Groupe​

Requête

curl -X GET https://api.syauth.com/e/v1/developer/groups/4e267feb-4409-4185-97cc-b34003aa1044/ \
  -H "X-Developer-Token: syat_..."

Réponse

{
  "id": "4e267feb-4409-4185-97cc-b34003aa1044",
  "name": "Beta Testers",
  "description": "Users with access to beta features",
  "workspace_id": "78047707-5f8f-472b-a065-3d3dc48ba80a",
  "member_count": 0,
  "created_at": "2026-01-07T10:15:00Z"
}

Mettre à Jour un Groupe​

Modifie le nom ou la description d'un groupe.

Requête

curl -X PATCH https://api.syauth.com/e/v1/developer/groups/4e267feb-4409-4185-97cc-b34003aa1044/ \
  -H "X-Developer-Token: syat_..." \
  -H "Content-Type: application/json" \
  -d '{"description": "Updated description"}'

Réponse

{
  "id": "4e267feb-4409-4185-97cc-b34003aa1044",
  "name": "Beta Testers",
  "description": "Updated description",
  "workspace_id": "78047707-5f8f-472b-a065-3d3dc48ba80a",
  "member_count": 0,
  "created_at": "2026-01-07T10:15:00Z"
}

Supprimer un Groupe​

Supprime définitivement un groupe.

Requête

curl -X DELETE https://api.syauth.com/e/v1/developer/groups/4e267feb-4409-4185-97cc-b34003aa1044/ \
  -H "X-Developer-Token: syat_..."

Réponse 204 No Content