invite_user
Inviter un utilisateur
Rôle#
Crée un utilisateur de l'organisation SANS mot de passe et lui envoie un lien d'accès (48 h, usage unique, passkey à enrôler) à son email de contact. login = identifiant de connexion (format email ; pour un consultant, dans le domaine du client) ; contactEmail = boîte réelle ; role = admin | manager | sales | finance. La réponse ne porte jamais d'email ni de donnée d'authentification. Demander la confirmation explicite de l'humain avant d'appeler.
Accès#
Scope principal : users:write. Le scope ne remplace pas les gardes de visibilité, d'organisation, de module ni les scopes complémentaires des gestes composés.
Catalogue complet · Approbations
Paramètres#
Le schéma ci-dessous est produit par la fonction qui enregistre les outils, y compris idempotency_key lorsqu'elle s'applique. Consultez les objets imbriqués dans le schéma complet.
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
name | string | Oui | |
login | string | Oui | |
contactEmail | string | Oui | |
role | string | Oui | Valeurs : admin, manager, sales, finance, reader, marketing, project, staff |
idempotency_key | string | Non | Clé d'idempotence (recommandée) : rejouer la MÊME mutation avec la même clé renvoie la réponse originale sans ré-exécuter - TTL 24 h |
Schéma JSON complet des paramètres
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"login": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"contactEmail": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"role": {
"type": "string",
"enum": [
"admin",
"manager",
"sales",
"finance",
"reader",
"marketing",
"project",
"staff"
]
},
"idempotency_key": {
"description": "Clé d'idempotence (recommandée) : rejouer la MÊME mutation avec la même clé renvoie la réponse originale sans ré-exécuter - TTL 24 h",
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"name",
"login",
"contactEmail",
"role"
],
"additionalProperties": false
}