**Versions de l’API** · **V2 (Latest)** · [V1](/integrations/v1/docs?lang=fr)

# Members

OpenAPI 3.0.3 · API 2.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v2",
    "description": "API"
  }
]
```

## Opérations

## GET /members/capabilities

Vérifier la disponibilité de l’administration des comptes membres et de la délégation à une application

`get_member_capabilities`

Exige members:read explicitement attribué. Découverte statique de capacité ; aucun paramètre de requête ni corps non vide n’est accepté et aucun enregistrement métier n’est lu. Les lectures de comptes et demandes familiales sont implémentées sous réserve de l’organisation et des droits courants ; les clés restreintes à des collectes peuvent découvrir ce même résultat statique mais ne peuvent pas lire de comptes. APPROVE_ACCOUNT et REJECT_ACCOUNT sont implémentés avec les droits explicites distincts members:approve et members:reject, une révision d’admission, une cible CRM exacte existante pour l’approbation, un journal de décision durable et une sérialisation externe. Les écritures internes ne partagent pas ce verrou et la synchronisation CRM n’est pas entièrement observable ; examiner l’état de décision sans promettre d’atomicité ni de synchronisation complète du profil. L’approbation/refus familial est implémenté avec ces mêmes droits explicites : titulaire, conjoint, cible existante, relations CRM directes/inverses et familles du chef sont admis avant effet. Chaque revision familiale couvre la demande, le titulaire et les conjoints candidats ; relatedContactIds est une observation, jamais une autorisation indépendante. memberApplication.supported=false avec DEFERRED_BY_PRODUCT_DECISION : l’accès membre depuis une application externe est reporté par décision produit et ne fait pas partie de cette livraison. Les clés API et autorisations OAuth d’organisation restent des identités d’organisation et ne doivent pas usurper un membre. Aucun parcours de connexion/consentement/session/échange d’identifiants membre n’est proposé. Signaler le report et arrêter ce parcours applicatif ; ne proposer ni identifiants ni contournement. Aucun email, fournisseur ni mutation métier ; l’authentification peut actualiser les données d’utilisation de la clé API.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "members:read",
  "additional": []
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Données actuelles observées de l’espace compte ou limites explicites de capacité.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/MemberCapabilities"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_QUERY, INVALID_MEMBER_CURSOR, INVALID_MEMBER_ID ou UNEXPECTED_REQUEST_BODY : corriger uniquement les arguments déclarés de la requête.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT ou CAMPAIGN_RESTRICTED_KEY : aucune donnée de compte n’a été renvoyée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_READ_UNAVAILABLE : échec temporaire de lecture ; aucune mutation métier n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /members/accounts

Lister les demandes d’accès aux comptes membres et leurs états d’approbation enregistrés

`list_member_accounts`

Exige le droit members:read explicitement attribué ; contacts:read et un rôle CRM administrateur ne le remplacent pas. Cette lecture relève de l’administration organisationnelle des comptes, pas de l’identité déléguée du membre courant. MEMBER_ACCOUNT, ACCOUNT_FAMILY_MEMBER, contact CRM et accès administrateur sont des objets et identifiants distincts. Une relation familiale CRM, un email identique ou le tag #ACCOUNT n’accorde jamais l’accès membre. SUBMIT signifie en attente d’approbation de l’espace compte, VALIDE signifie approbation/rattachement enregistré, REJECTED signifie refusé et peut être approuvé à nouveau ; ce ne sont pas des états de paiement ou d’inscription. La vérification de l’email seule n’est pas une approbation. Profile contient uniquement les prénom/nom, email et téléphone du miroir ; il peut différer de l’identité CRM actuelle. linkedContactId, lorsqu’il est présent, est réadmis dans la même organisation sans renvoyer de champs CRM ; utiliser les outils CRM et leurs propres droits pour ces données. Une identité, une date ou un booléen null signifie inconnu/absent, jamais un false ou zéro déduit. Les dates sont ISO 8601 UTC ou null. Aucun mot de passe, OTP, lien de réinitialisation, session, identifiant réutilisable, CRM brut, champ complémentaire de profil, paramètre privé ni donnée fournisseur n’est renvoyé. Lecture seule : aucun rattachement, approbation, refus, émission/révocation de session, synchronisation de profil, email, appel fournisseur ni écriture métier. L’authentification peut actualiser les données d’utilisation de la clé API. Les clés restreintes à des collectes reçoivent 403 CAMPAIGN_RESTRICTED_KEY car l’appartenance indépendante des comptes à une collecte n’est pas établie. Un objet absent, supprimé, étranger ou lié de manière inadmissible renvoie 404 MEMBER_NOT_FOUND ; doublons ambigus d’identifiant, historique mal formé ou page modifiée renvoient 409. Arrêter sur ces erreurs ; ne pas déduire de droit d’accès ni corriger par des modifications de contacts. Les lectures de comptes renvoient une revision opaque pour l’approbation/refus conditionnel ; elle est vérifiée à l’admission, sans CAS atomique avec les écritures internes. Les décisions sur le titulaire et la famille exigent les droits exacts de leur action ; l’accès membre depuis une application externe est reporté par décision produit : consulter get_member_capabilities. state vaut SUBMIT par défaut ; utiliser ALL pour tous les états enregistrés. Les pages sont triées par identifiant exact croissant, avec limit à 50 par défaut et 100 au maximum. nextCursor est opaque et lié à l’organisation, à la ressource, à state et au filtre accountId ; conserver les filtres et le suivre jusqu’à hasMore=false uniquement si une liste complète est nécessaire. count est le nombre de lignes de cette page, jamais un total. Les pages sont des lectures courantes distinctes, sans transaction ni photographie historique stable ; des modifications concurrentes peuvent affecter le parcours. Une liste sans toutes ses pages est partielle. Seuls les paramètres de requête déclarés sont admis ; répétitions, erreurs de type scalaire, paramètres inconnus et corps non vide sont refusés.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "members:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "state",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "SUBMIT",
      "VALIDE",
      "REJECTED",
      "ALL"
    ],
    "default": "SUBMIT"
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 100,
    "default": 50
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "maxLength": 400,
    "pattern": "^[A-Za-z0-9_-]+$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Page actuelle bornée ; count est la taille de la page, pas le total de l’organisation.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "meta"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/MemberAccount"
            }
          },
          "meta": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "count",
              "hasMore",
              "nextCursor"
            ],
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100
              },
              "hasMore": {
                "type": "boolean"
              },
              "nextCursor": {
                "type": "string",
                "nullable": true
              }
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_QUERY, INVALID_MEMBER_CURSOR, INVALID_MEMBER_ID ou UNEXPECTED_REQUEST_BODY : corriger uniquement les arguments déclarés de la requête.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT ou CAMPAIGN_RESTRICTED_KEY : aucune donnée de compte n’a été renvoyée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND : objet ou relation absent, supprimé, étranger à l’organisation ou inadmissible.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_MEMBER_HISTORY : historique ambigu ou mal formé ; aucune mutation ni correction automatique.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_READ_UNAVAILABLE : échec temporaire de lecture ; aucune mutation métier n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /members/accounts/{id}

Lire une demande d’accès à un compte membre

`get_member_account`

Exige le droit members:read explicitement attribué ; contacts:read et un rôle CRM administrateur ne le remplacent pas. Cette lecture relève de l’administration organisationnelle des comptes, pas de l’identité déléguée du membre courant. MEMBER_ACCOUNT, ACCOUNT_FAMILY_MEMBER, contact CRM et accès administrateur sont des objets et identifiants distincts. Une relation familiale CRM, un email identique ou le tag #ACCOUNT n’accorde jamais l’accès membre. SUBMIT signifie en attente d’approbation de l’espace compte, VALIDE signifie approbation/rattachement enregistré, REJECTED signifie refusé et peut être approuvé à nouveau ; ce ne sont pas des états de paiement ou d’inscription. La vérification de l’email seule n’est pas une approbation. Profile contient uniquement les prénom/nom, email et téléphone du miroir ; il peut différer de l’identité CRM actuelle. linkedContactId, lorsqu’il est présent, est réadmis dans la même organisation sans renvoyer de champs CRM ; utiliser les outils CRM et leurs propres droits pour ces données. Une identité, une date ou un booléen null signifie inconnu/absent, jamais un false ou zéro déduit. Les dates sont ISO 8601 UTC ou null. Aucun mot de passe, OTP, lien de réinitialisation, session, identifiant réutilisable, CRM brut, champ complémentaire de profil, paramètre privé ni donnée fournisseur n’est renvoyé. Lecture seule : aucun rattachement, approbation, refus, émission/révocation de session, synchronisation de profil, email, appel fournisseur ni écriture métier. L’authentification peut actualiser les données d’utilisation de la clé API. Les clés restreintes à des collectes reçoivent 403 CAMPAIGN_RESTRICTED_KEY car l’appartenance indépendante des comptes à une collecte n’est pas établie. Un objet absent, supprimé, étranger ou lié de manière inadmissible renvoie 404 MEMBER_NOT_FOUND ; doublons ambigus d’identifiant, historique mal formé ou page modifiée renvoient 409. Arrêter sur ces erreurs ; ne pas déduire de droit d’accès ni corriger par des modifications de contacts. Les lectures de comptes renvoient une revision opaque pour l’approbation/refus conditionnel ; elle est vérifiée à l’admission, sans CAS atomique avec les écritures internes. Les décisions sur le titulaire et la famille exigent les droits exacts de leur action ; l’accès membre depuis une application externe est reporté par décision produit : consulter get_member_capabilities. Fournir un UUID de compte renvoyé par list_member_accounts, jamais un UUID de contact CRM ni un identifiant d’accès administrateur. Aucun paramètre de requête ni corps non vide n’est accepté. Le résultat inclut la revision opaque courante ; une décision exige toujours le droit et l’intention exacts de l’action.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "members:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Données actuelles observées de l’espace compte ou limites explicites de capacité.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/MemberAccount"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_QUERY, INVALID_MEMBER_CURSOR, INVALID_MEMBER_ID ou UNEXPECTED_REQUEST_BODY : corriger uniquement les arguments déclarés de la requête.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT ou CAMPAIGN_RESTRICTED_KEY : aucune donnée de compte n’a été renvoyée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND : objet ou relation absent, supprimé, étranger à l’organisation ou inadmissible.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_MEMBER_HISTORY : historique ambigu ou mal formé ; aucune mutation ni correction automatique.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_READ_UNAVAILABLE : échec temporaire de lecture ; aucune mutation métier n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /members/family-requests

Lister les demandes d’accès des membres de famille et leurs états d’approbation

`list_member_family_requests`

Exige le droit members:read explicitement attribué ; contacts:read et un rôle CRM administrateur ne le remplacent pas. Cette lecture relève de l’administration organisationnelle des comptes, pas de l’identité déléguée du membre courant. MEMBER_ACCOUNT, ACCOUNT_FAMILY_MEMBER, contact CRM et accès administrateur sont des objets et identifiants distincts. Une relation familiale CRM, un email identique ou le tag #ACCOUNT n’accorde jamais l’accès membre. SUBMIT signifie en attente d’approbation de l’espace compte, VALIDE signifie approbation/rattachement enregistré, REJECTED signifie refusé et peut être approuvé à nouveau ; ce ne sont pas des états de paiement ou d’inscription. La vérification de l’email seule n’est pas une approbation. Profile contient uniquement les prénom/nom, email et téléphone du miroir ; il peut différer de l’identité CRM actuelle. linkedContactId, lorsqu’il est présent, est réadmis dans la même organisation sans renvoyer de champs CRM ; utiliser les outils CRM et leurs propres droits pour ces données. Une identité, une date ou un booléen null signifie inconnu/absent, jamais un false ou zéro déduit. Les dates sont ISO 8601 UTC ou null. Aucun mot de passe, OTP, lien de réinitialisation, session, identifiant réutilisable, CRM brut, champ complémentaire de profil, paramètre privé ni donnée fournisseur n’est renvoyé. Lecture seule : aucun rattachement, approbation, refus, émission/révocation de session, synchronisation de profil, email, appel fournisseur ni écriture métier. L’authentification peut actualiser les données d’utilisation de la clé API. Les clés restreintes à des collectes reçoivent 403 CAMPAIGN_RESTRICTED_KEY car l’appartenance indépendante des comptes à une collecte n’est pas établie. Un objet absent, supprimé, étranger ou lié de manière inadmissible renvoie 404 MEMBER_NOT_FOUND ; doublons ambigus d’identifiant, historique mal formé ou page modifiée renvoient 409. Arrêter sur ces erreurs ; ne pas déduire de droit d’accès ni corriger par des modifications de contacts. Les lectures de comptes renvoient une revision opaque pour l’approbation/refus conditionnel ; elle est vérifiée à l’admission, sans CAS atomique avec les écritures internes. Les décisions sur le titulaire et la famille exigent les droits exacts de leur action ; l’accès membre depuis une application externe est reporté par décision produit : consulter get_member_capabilities. L’accountId de chaque demande familiale est réadmis dans la même organisation. L’approbation du titulaire n’approuve pas chaque proche. CONJOINT signifie conjoint/partenaire et ENFANT enfant ; cette relation est celle enregistrée dans la demande d’espace compte, pas une preuve CRM indépendante. Une demande familiale peut exister dans le backend alors que son affichage est désactivé ; cette lecture ne prouve pas que la fonctionnalité soit actuellement activée. state vaut SUBMIT par défaut ; utiliser ALL pour tous les états enregistrés. Les pages sont triées par identifiant exact croissant, avec limit à 50 par défaut et 100 au maximum. nextCursor est opaque et lié à l’organisation, à la ressource, à state et au filtre accountId ; conserver les filtres et le suivre jusqu’à hasMore=false uniquement si une liste complète est nécessaire. count est le nombre de lignes de cette page, jamais un total. Les pages sont des lectures courantes distinctes, sans transaction ni photographie historique stable ; des modifications concurrentes peuvent affecter le parcours. Une liste sans toutes ses pages est partielle. Seuls les paramètres de requête déclarés sont admis ; répétitions, erreurs de type scalaire, paramètres inconnus et corps non vide sont refusés.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "members:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "state",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "SUBMIT",
      "VALIDE",
      "REJECTED",
      "ALL"
    ],
    "default": "SUBMIT"
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 100,
    "default": 50
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "maxLength": 400,
    "pattern": "^[A-Za-z0-9_-]+$"
  }
}
```

```json
{
  "name": "accountId",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID exact facultatif du compte membre parent, réadmis indépendamment dans l’organisation courante."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Page actuelle bornée ; count est la taille de la page, pas le total de l’organisation.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "meta"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/MemberFamilyRequest"
            }
          },
          "meta": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "count",
              "hasMore",
              "nextCursor"
            ],
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100
              },
              "hasMore": {
                "type": "boolean"
              },
              "nextCursor": {
                "type": "string",
                "nullable": true
              }
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_QUERY, INVALID_MEMBER_CURSOR, INVALID_MEMBER_ID ou UNEXPECTED_REQUEST_BODY : corriger uniquement les arguments déclarés de la requête.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT ou CAMPAIGN_RESTRICTED_KEY : aucune donnée de compte n’a été renvoyée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND : objet ou relation absent, supprimé, étranger à l’organisation ou inadmissible.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_MEMBER_HISTORY : historique ambigu ou mal formé ; aucune mutation ni correction automatique.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_READ_UNAVAILABLE : échec temporaire de lecture ; aucune mutation métier n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /members/family-requests/{id}

Lire une demande d’accès d’un membre de famille

`get_member_family_request`

Exige le droit members:read explicitement attribué ; contacts:read et un rôle CRM administrateur ne le remplacent pas. Cette lecture relève de l’administration organisationnelle des comptes, pas de l’identité déléguée du membre courant. MEMBER_ACCOUNT, ACCOUNT_FAMILY_MEMBER, contact CRM et accès administrateur sont des objets et identifiants distincts. Une relation familiale CRM, un email identique ou le tag #ACCOUNT n’accorde jamais l’accès membre. SUBMIT signifie en attente d’approbation de l’espace compte, VALIDE signifie approbation/rattachement enregistré, REJECTED signifie refusé et peut être approuvé à nouveau ; ce ne sont pas des états de paiement ou d’inscription. La vérification de l’email seule n’est pas une approbation. Profile contient uniquement les prénom/nom, email et téléphone du miroir ; il peut différer de l’identité CRM actuelle. linkedContactId, lorsqu’il est présent, est réadmis dans la même organisation sans renvoyer de champs CRM ; utiliser les outils CRM et leurs propres droits pour ces données. Une identité, une date ou un booléen null signifie inconnu/absent, jamais un false ou zéro déduit. Les dates sont ISO 8601 UTC ou null. Aucun mot de passe, OTP, lien de réinitialisation, session, identifiant réutilisable, CRM brut, champ complémentaire de profil, paramètre privé ni donnée fournisseur n’est renvoyé. Lecture seule : aucun rattachement, approbation, refus, émission/révocation de session, synchronisation de profil, email, appel fournisseur ni écriture métier. L’authentification peut actualiser les données d’utilisation de la clé API. Les clés restreintes à des collectes reçoivent 403 CAMPAIGN_RESTRICTED_KEY car l’appartenance indépendante des comptes à une collecte n’est pas établie. Un objet absent, supprimé, étranger ou lié de manière inadmissible renvoie 404 MEMBER_NOT_FOUND ; doublons ambigus d’identifiant, historique mal formé ou page modifiée renvoient 409. Arrêter sur ces erreurs ; ne pas déduire de droit d’accès ni corriger par des modifications de contacts. Les lectures de comptes renvoient une revision opaque pour l’approbation/refus conditionnel ; elle est vérifiée à l’admission, sans CAS atomique avec les écritures internes. Les décisions sur le titulaire et la famille exigent les droits exacts de leur action ; l’accès membre depuis une application externe est reporté par décision produit : consulter get_member_capabilities. Fournir un UUID de membre de famille de compte issu de list_member_family_requests, jamais son accountId parent ni un UUID de contact CRM. Le compte parent accountId est réadmis dans la même organisation. CONJOINT signifie conjoint/partenaire et ENFANT enfant ; ni une relation enregistrée ni l’approbation du titulaire ne prouve l’accès de ce proche. Aucun paramètre de requête ni corps non vide n’est accepté. Les paramètres d’activation de la famille ne sont pas exposés et peuvent masquer des demandes existantes dans l’interface du produit.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "members:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Données actuelles observées de l’espace compte ou limites explicites de capacité.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/MemberFamilyRequest"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_QUERY, INVALID_MEMBER_CURSOR, INVALID_MEMBER_ID ou UNEXPECTED_REQUEST_BODY : corriger uniquement les arguments déclarés de la requête.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT ou CAMPAIGN_RESTRICTED_KEY : aucune donnée de compte n’a été renvoyée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND : objet ou relation absent, supprimé, étranger à l’organisation ou inadmissible.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_MEMBER_HISTORY : historique ambigu ou mal formé ; aucune mutation ni correction automatique.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_READ_UNAVAILABLE : échec temporaire de lecture ; aucune mutation métier n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /members/accounts/{id}/approve

Approuver un compte membre avec une cible CRM existante et exacte

`approve_member_account`

Exige members:approve. Commande d’administration de compte, jamais une usurpation de membre ni un octroi du rôle administrateur. Exige members:read ET le droit explicite de l’action. Lire d’abord get_member_account ou get_member_family_request selon l’objet et transmettre sa revision exacte dans expectedRevision ; fournir un nouvel UUID idempotencyKey pour cette intention exacte et conserver ces deux valeurs si la réponse est perdue. Aucun paramètre de requête ni champ de corps inconnu n’est accepté. Les identifiants natifs globaux du compte/contact et les tuples exacts d’organisation sont vérifiés avant l’appel au propriétaire existant. Chaque réservation de verrou/journal exige acknowledged:true et son insertedId exact avec writeConcern:{w:1,j:true} avant le propriétaire ; les CAS inline et la confirmation terminale exigent un ACK durable positif. Un journal durable et des verrous sans expiration du compte et du contact sérialisent les commandes externes ; les écritures internes du produit ne partagent pas ce verrou. La révision est vérifiée à l’admission juste avant le propriétaire, sans atomicité avec ses écritures : des modifications internes concurrentes restent possibles et sont signalées explicitement. APPLIED signifie que le propriétaire a répondu et que l’état/rattachement demandé du compte a été observé, pas une synchronisation CRM complète, une livraison email, l’émission d’identifiants, un paiement ou une inscription. crmSynchronization vaut toujours NOT_VERIFIED car le propriétaire CRM absorbe certaines erreurs en interne. account est la postlecture actuelle et peut différer lors d’un rejeu ultérieur ; resultRevision identifie la première observation confirmée. UNKNOWN signifie que le propriétaire a pu appliquer partiellement ou complètement la décision ou que la confirmation durable a échoué ; conserver la même identité de décision, consulter l’état courant et demander un rapprochement dans le parcours produit existant. Ne jamais réessayer avec un nouvel idempotencyKey, expectedRevision ou une autre cible pour contourner UNKNOWN. Un rejeu avec la même clé ne rappelle jamais le propriétaire ; un journal apparemment APPLIED dont la commande conserve un verrou reste UNKNOWN ; un changement d’intention renvoie 409 MEMBER_IDEMPOTENCY_CONFLICT. Un verrou sans résultat récupérable renvoie 409 MEMBER_DECISION_IN_PROGRESS ; aucun déverrouillage après délai ni rejeu automatique du propriétaire. NOT_APPLIED signifie qu’une seconde admission a échoué avant l’appel au propriétaire ; reason identifie la précondition refusée. Les erreurs 409 de révision/état/identité/cible signifient qu’aucun nouvel appel au propriétaire n’a eu lieu. Les références absentes/étrangères/supprimées renvoient 404. Les clés restreintes à des collectes renvoient 403. Aucun mot de passe, réinitialisation, OTP, session, token, secret ni erreur brute du propriétaire n’est accepté ou renvoyé. Aucun email d’activation n’est envoyé par ces endpoints. L’approbation accepte uniquement les comptes SUBMIT ou REJECTED avec emailVerified=true et active absent ou booléen valide différent de false. targetContactId est obligatoire et identifie un contact existant globalement unique dans cette organisation, choisi selon l’intention réelle de l’administrateur ; la cible ne doit pas appartenir à un autre compte/lien familial actif. Aucun matching par email/nom/famille, création de contact ou nouveau rattachement à un autre ancien contact n’est effectué. Le propriétaire existant initialise le miroir de profil, marque VALIDE et tente sa synchronisation CRM habituelle. La structure de l’identité et des adresses de la source/cible doit être valide. Vérification absente, profil invalide, état actuel VALIDE, cible en conflit ou changement de rattachement renvoient 409 ; résoudre l’ambiguïté réelle sans fabriquer de contact ni de tag. Après la seconde admission, le garde commun des mutations externes vérifie les ressources exactes réadmises avant tout propriétaire ou CAS inline. CONTACT_MUTATION_BLOCKED ou CONTACT_MUTATION_FENCE_UNAVAILABLE enregistre NOT_APPLIED avant effet ; le rejeu ne réessaie pas cette intention refusée. Si le résultat du propriétaire et le journal terminal ont été positivement confirmés dans la requête courante, un échec du nettoyage des verrous conserve APPLIED avec reason MEMBER_DECISION_CLEANUP_UNCONFIRMED ; les verrous peuvent rester, sans autoriser une nouvelle commande. Un rejeu ultérieur avec verrous conservés reste UNKNOWN sans preuve durable fraîche de confirmation terminale.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "members:approve",
  "additional": [
    "members:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "targetContactId": {
            "type": "string",
            "format": "uuid"
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "targetContactId"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat enregistré : examiner APPLIED, NOT_APPLIED ou UNKNOWN avant de conclure à une modification d’accès.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "replayed",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/MemberDecision"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_DECISION, INVALID_MEMBER_QUERY ou INVALID_MEMBER_ID : fournir uniquement les arguments exacts déclarés de la commande.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT ou CAMPAIGN_RESTRICTED_KEY : aucune donnée de compte n’a été renvoyée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND : compte ou référence actuellement inadmissible. Une réponse perdue ou un échec de postlecture ne doit pas déclencher une nouvelle identité de décision.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "MEMBER_REVISION_CONFLICT, AMBIGUOUS_MEMBER_IDENTITY, MEMBER_APPROVAL_PRECONDITION, MEMBER_REJECTION_PRECONDITION, MEMBER_REBIND_UNAVAILABLE, MEMBER_TARGET_CONFLICT, MEMBER_IDEMPOTENCY_CONFLICT, MEMBER_DECISION_IN_PROGRESS, MEMBER_FAMILY_CONFLICT, MEMBER_FAMILY_LIMIT ou INVALID_MEMBER_HISTORY : examiner le motif exact ; ne jamais contourner une décision en cours ou inconnue avec une autre clé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_DECISION_UNAVAILABLE : aucun résultat confirmé disponible. Conserver idempotencyKey et l’intention d’origine, consulter l’état courant et ne rejouer que cette même intention ; ne jamais en déduire une absence d’effet.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:approve",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-additional-scopes": [
    "members:read"
  ]
}
```

## POST /members/accounts/{id}/reject

Refuser une demande d’accès à un compte membre

`reject_member_account`

Exige members:reject. Commande d’administration de compte, jamais une usurpation de membre ni un octroi du rôle administrateur. Exige members:read ET le droit explicite de l’action. Lire d’abord get_member_account ou get_member_family_request selon l’objet et transmettre sa revision exacte dans expectedRevision ; fournir un nouvel UUID idempotencyKey pour cette intention exacte et conserver ces deux valeurs si la réponse est perdue. Aucun paramètre de requête ni champ de corps inconnu n’est accepté. Les identifiants natifs globaux du compte/contact et les tuples exacts d’organisation sont vérifiés avant l’appel au propriétaire existant. Chaque réservation de verrou/journal exige acknowledged:true et son insertedId exact avec writeConcern:{w:1,j:true} avant le propriétaire ; les CAS inline et la confirmation terminale exigent un ACK durable positif. Un journal durable et des verrous sans expiration du compte et du contact sérialisent les commandes externes ; les écritures internes du produit ne partagent pas ce verrou. La révision est vérifiée à l’admission juste avant le propriétaire, sans atomicité avec ses écritures : des modifications internes concurrentes restent possibles et sont signalées explicitement. APPLIED signifie que le propriétaire a répondu et que l’état/rattachement demandé du compte a été observé, pas une synchronisation CRM complète, une livraison email, l’émission d’identifiants, un paiement ou une inscription. crmSynchronization vaut toujours NOT_VERIFIED car le propriétaire CRM absorbe certaines erreurs en interne. account est la postlecture actuelle et peut différer lors d’un rejeu ultérieur ; resultRevision identifie la première observation confirmée. UNKNOWN signifie que le propriétaire a pu appliquer partiellement ou complètement la décision ou que la confirmation durable a échoué ; conserver la même identité de décision, consulter l’état courant et demander un rapprochement dans le parcours produit existant. Ne jamais réessayer avec un nouvel idempotencyKey, expectedRevision ou une autre cible pour contourner UNKNOWN. Un rejeu avec la même clé ne rappelle jamais le propriétaire ; un journal apparemment APPLIED dont la commande conserve un verrou reste UNKNOWN ; un changement d’intention renvoie 409 MEMBER_IDEMPOTENCY_CONFLICT. Un verrou sans résultat récupérable renvoie 409 MEMBER_DECISION_IN_PROGRESS ; aucun déverrouillage après délai ni rejeu automatique du propriétaire. NOT_APPLIED signifie qu’une seconde admission a échoué avant l’appel au propriétaire ; reason identifie la précondition refusée. Les erreurs 409 de révision/état/identité/cible signifient qu’aucun nouvel appel au propriétaire n’a eu lieu. Les références absentes/étrangères/supprimées renvoient 404. Les clés restreintes à des collectes renvoient 403. Aucun mot de passe, réinitialisation, OTP, session, token, secret ni erreur brute du propriétaire n’est accepté ou renvoyé. Aucun email d’activation n’est envoyé par ces endpoints. Le refus accepte les comptes SUBMIT ou VALIDE et marque REJECTED via le propriétaire existant. Il nettoie le pointeur CRM de compte dénormalisé correspondant lorsqu’il existe ; il ne supprime pas le contact, ne retire pas les relations familiales, ne révoque pas les sessions existantes et ne modifie pas les paiements/inscriptions. selfContact conservé est un lien historique, pas une preuve d’accès actuel. Un compte déjà REJECTED renvoie 409 pour une nouvelle commande ; rejouer la clé d’origine pour le résultat initial. Après la seconde admission, le garde commun des mutations externes vérifie les ressources exactes réadmises avant tout propriétaire ou CAS inline. CONTACT_MUTATION_BLOCKED ou CONTACT_MUTATION_FENCE_UNAVAILABLE enregistre NOT_APPLIED avant effet ; le rejeu ne réessaie pas cette intention refusée. Si le résultat du propriétaire et le journal terminal ont été positivement confirmés dans la requête courante, un échec du nettoyage des verrous conserve APPLIED avec reason MEMBER_DECISION_CLEANUP_UNCONFIRMED ; les verrous peuvent rester, sans autoriser une nouvelle commande. Un rejeu ultérieur avec verrous conservés reste UNKNOWN sans preuve durable fraîche de confirmation terminale.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "members:reject",
  "additional": [
    "members:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat enregistré : examiner APPLIED, NOT_APPLIED ou UNKNOWN avant de conclure à une modification d’accès.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "replayed",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/MemberDecision"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_DECISION, INVALID_MEMBER_QUERY ou INVALID_MEMBER_ID : fournir uniquement les arguments exacts déclarés de la commande.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT ou CAMPAIGN_RESTRICTED_KEY : aucune donnée de compte n’a été renvoyée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND : compte ou référence actuellement inadmissible. Une réponse perdue ou un échec de postlecture ne doit pas déclencher une nouvelle identité de décision.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "MEMBER_REVISION_CONFLICT, AMBIGUOUS_MEMBER_IDENTITY, MEMBER_APPROVAL_PRECONDITION, MEMBER_REJECTION_PRECONDITION, MEMBER_REBIND_UNAVAILABLE, MEMBER_TARGET_CONFLICT, MEMBER_IDEMPOTENCY_CONFLICT, MEMBER_DECISION_IN_PROGRESS, MEMBER_FAMILY_CONFLICT, MEMBER_FAMILY_LIMIT ou INVALID_MEMBER_HISTORY : examiner le motif exact ; ne jamais contourner une décision en cours ou inconnue avec une autre clé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_DECISION_UNAVAILABLE : aucun résultat confirmé disponible. Conserver idempotencyKey et l’intention d’origine, consulter l’état courant et ne rejouer que cette même intention ; ne jamais en déduire une absence d’effet.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:reject",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-additional-scopes": [
    "members:read"
  ]
}
```

## POST /members/family-requests/{id}/approve

Approuver une demande d’accès familiale avec une cible CRM existante et exacte

`approve_member_family_request`

Exige members:approve. Commande d’administration de compte, jamais une usurpation de membre ni un octroi du rôle administrateur. Exige members:read ET le droit explicite de l’action. Lire d’abord get_member_account ou get_member_family_request selon l’objet et transmettre sa revision exacte dans expectedRevision ; fournir un nouvel UUID idempotencyKey pour cette intention exacte et conserver ces deux valeurs si la réponse est perdue. Aucun paramètre de requête ni champ de corps inconnu n’est accepté. Les identifiants natifs globaux du compte/contact et les tuples exacts d’organisation sont vérifiés avant l’appel au propriétaire existant. Chaque réservation de verrou/journal exige acknowledged:true et son insertedId exact avec writeConcern:{w:1,j:true} avant le propriétaire ; les CAS inline et la confirmation terminale exigent un ACK durable positif. Un journal durable et des verrous sans expiration du compte et du contact sérialisent les commandes externes ; les écritures internes du produit ne partagent pas ce verrou. La révision est vérifiée à l’admission juste avant le propriétaire, sans atomicité avec ses écritures : des modifications internes concurrentes restent possibles et sont signalées explicitement. APPLIED signifie que le propriétaire a répondu et que l’état/rattachement demandé du compte a été observé, pas une synchronisation CRM complète, une livraison email, l’émission d’identifiants, un paiement ou une inscription. crmSynchronization vaut toujours NOT_VERIFIED car le propriétaire CRM absorbe certaines erreurs en interne. account est la postlecture actuelle et peut différer lors d’un rejeu ultérieur ; resultRevision identifie la première observation confirmée. UNKNOWN signifie que le propriétaire a pu appliquer partiellement ou complètement la décision ou que la confirmation durable a échoué ; conserver la même identité de décision, consulter l’état courant et demander un rapprochement dans le parcours produit existant. Ne jamais réessayer avec un nouvel idempotencyKey, expectedRevision ou une autre cible pour contourner UNKNOWN. Un rejeu avec la même clé ne rappelle jamais le propriétaire ; un journal apparemment APPLIED dont la commande conserve un verrou reste UNKNOWN ; un changement d’intention renvoie 409 MEMBER_IDEMPOTENCY_CONFLICT. Un verrou sans résultat récupérable renvoie 409 MEMBER_DECISION_IN_PROGRESS ; aucun déverrouillage après délai ni rejeu automatique du propriétaire. NOT_APPLIED signifie qu’une seconde admission a échoué avant l’appel au propriétaire ; reason identifie la précondition refusée. Les erreurs 409 de révision/état/identité/cible signifient qu’aucun nouvel appel au propriétaire n’a eu lieu. Les références absentes/étrangères/supprimées renvoient 404. Les clés restreintes à des collectes renvoient 403. Aucun mot de passe, réinitialisation, OTP, session, token, secret ni erreur brute du propriétaire n’est accepté ou renvoyé. Aucun email d’activation n’est envoyé par ces endpoints. Fournir l’UUID de la demande familiale, pas son accountId parent ni un identifiant de contact CRM. Lire d’abord get_member_family_request : sa revision couvre la demande, le titulaire actuel et les conjoints candidats enregistrés ; relatedContactIds indique le titulaire et, pour un enfant, le conjoint actuellement validé lorsqu’il existe. Ces identifiants sont une observation courante, jamais une autorité indépendante. Chaque décision familiale verrouille le compte parent, la demande et les contacts CRM touchés. Au maximum 200 conjoints candidats et 2000 entrées de relation CRM par contact touché sont admis ; titulaire/conjoint/famille du chef ambigu, étranger, dupliqué ou mal formé provoque 409 ou 404 avant effet. L’approbation accepte les demandes SUBMIT ou REJECTED avec un profil valide et un titulaire actuellement VALIDE, avec email vérifié, non inactif et rattaché à un contact CRM. targetContactId doit être un contact existant globalement unique de la même organisation, distinct du titulaire/conjoint validé et non attribué à un autre titulaire/demande familiale validé. Le rattachement à un autre ancien contact est refusé. CONJOINT n’admet aucune autre demande de conjoint non refusée. ENFANT utilise comme parents le titulaire et au plus un conjoint actuellement validé ; toutes les identités inférées par le propriétaire natif sont admises globalement avant l’appel à bindMember. Les deux sens de chaque relation sont contrôlés avant effet contre les types contradictoires, puis après le propriétaire. La propagation native des familles du chef est également admise. Une cible existante évite tout matching/création, même pour un enfant sans coordonnées. APPLIED confirme l’état/rattachement familial enregistré et l’observation des relations directes/inverses requises ; la synchronisation de profil demeure NOT_VERIFIED. Ajouter un conjoint ne rattache pas rétroactivement les enfants déjà enregistrés à ce conjoint. Après la seconde admission, le garde commun des mutations externes vérifie les ressources exactes réadmises avant tout propriétaire ou CAS inline. CONTACT_MUTATION_BLOCKED ou CONTACT_MUTATION_FENCE_UNAVAILABLE enregistre NOT_APPLIED avant effet ; le rejeu ne réessaie pas cette intention refusée. Si le résultat du propriétaire et le journal terminal ont été positivement confirmés dans la requête courante, un échec du nettoyage des verrous conserve APPLIED avec reason MEMBER_DECISION_CLEANUP_UNCONFIRMED ; les verrous peuvent rester, sans autoriser une nouvelle commande. Un rejeu ultérieur avec verrous conservés reste UNKNOWN sans preuve durable fraîche de confirmation terminale.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "members:approve",
  "additional": [
    "members:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "targetContactId": {
            "type": "string",
            "format": "uuid"
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "targetContactId"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat enregistré : examiner APPLIED, NOT_APPLIED ou UNKNOWN avant de conclure à une modification d’accès.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "replayed",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/MemberFamilyDecision"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_DECISION, INVALID_MEMBER_QUERY ou INVALID_MEMBER_ID : fournir uniquement les arguments exacts déclarés de la commande.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT ou CAMPAIGN_RESTRICTED_KEY : aucune donnée de compte n’a été renvoyée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND : compte ou référence actuellement inadmissible. Une réponse perdue ou un échec de postlecture ne doit pas déclencher une nouvelle identité de décision.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "MEMBER_REVISION_CONFLICT, AMBIGUOUS_MEMBER_IDENTITY, MEMBER_APPROVAL_PRECONDITION, MEMBER_REJECTION_PRECONDITION, MEMBER_REBIND_UNAVAILABLE, MEMBER_TARGET_CONFLICT, MEMBER_IDEMPOTENCY_CONFLICT, MEMBER_DECISION_IN_PROGRESS, MEMBER_FAMILY_CONFLICT, MEMBER_FAMILY_LIMIT ou INVALID_MEMBER_HISTORY : examiner le motif exact ; ne jamais contourner une décision en cours ou inconnue avec une autre clé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_DECISION_UNAVAILABLE : aucun résultat confirmé disponible. Conserver idempotencyKey et l’intention d’origine, consulter l’état courant et ne rejouer que cette même intention ; ne jamais en déduire une absence d’effet.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:approve",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-additional-scopes": [
    "members:read"
  ]
}
```

## POST /members/family-requests/{id}/reject

Refuser une demande d’accès familiale

`reject_member_family_request`

Exige members:reject. Commande d’administration de compte, jamais une usurpation de membre ni un octroi du rôle administrateur. Exige members:read ET le droit explicite de l’action. Lire d’abord get_member_account ou get_member_family_request selon l’objet et transmettre sa revision exacte dans expectedRevision ; fournir un nouvel UUID idempotencyKey pour cette intention exacte et conserver ces deux valeurs si la réponse est perdue. Aucun paramètre de requête ni champ de corps inconnu n’est accepté. Les identifiants natifs globaux du compte/contact et les tuples exacts d’organisation sont vérifiés avant l’appel au propriétaire existant. Chaque réservation de verrou/journal exige acknowledged:true et son insertedId exact avec writeConcern:{w:1,j:true} avant le propriétaire ; les CAS inline et la confirmation terminale exigent un ACK durable positif. Un journal durable et des verrous sans expiration du compte et du contact sérialisent les commandes externes ; les écritures internes du produit ne partagent pas ce verrou. La révision est vérifiée à l’admission juste avant le propriétaire, sans atomicité avec ses écritures : des modifications internes concurrentes restent possibles et sont signalées explicitement. APPLIED signifie que le propriétaire a répondu et que l’état/rattachement demandé du compte a été observé, pas une synchronisation CRM complète, une livraison email, l’émission d’identifiants, un paiement ou une inscription. crmSynchronization vaut toujours NOT_VERIFIED car le propriétaire CRM absorbe certaines erreurs en interne. account est la postlecture actuelle et peut différer lors d’un rejeu ultérieur ; resultRevision identifie la première observation confirmée. UNKNOWN signifie que le propriétaire a pu appliquer partiellement ou complètement la décision ou que la confirmation durable a échoué ; conserver la même identité de décision, consulter l’état courant et demander un rapprochement dans le parcours produit existant. Ne jamais réessayer avec un nouvel idempotencyKey, expectedRevision ou une autre cible pour contourner UNKNOWN. Un rejeu avec la même clé ne rappelle jamais le propriétaire ; un journal apparemment APPLIED dont la commande conserve un verrou reste UNKNOWN ; un changement d’intention renvoie 409 MEMBER_IDEMPOTENCY_CONFLICT. Un verrou sans résultat récupérable renvoie 409 MEMBER_DECISION_IN_PROGRESS ; aucun déverrouillage après délai ni rejeu automatique du propriétaire. NOT_APPLIED signifie qu’une seconde admission a échoué avant l’appel au propriétaire ; reason identifie la précondition refusée. Les erreurs 409 de révision/état/identité/cible signifient qu’aucun nouvel appel au propriétaire n’a eu lieu. Les références absentes/étrangères/supprimées renvoient 404. Les clés restreintes à des collectes renvoient 403. Aucun mot de passe, réinitialisation, OTP, session, token, secret ni erreur brute du propriétaire n’est accepté ou renvoyé. Aucun email d’activation n’est envoyé par ces endpoints. Fournir l’UUID de la demande familiale, pas son accountId parent ni un identifiant de contact CRM. Lire d’abord get_member_family_request : sa revision couvre la demande, le titulaire actuel et les conjoints candidats enregistrés ; relatedContactIds indique le titulaire et, pour un enfant, le conjoint actuellement validé lorsqu’il existe. Ces identifiants sont une observation courante, jamais une autorité indépendante. Chaque décision familiale verrouille le compte parent, la demande et les contacts CRM touchés. Au maximum 200 conjoints candidats et 2000 entrées de relation CRM par contact touché sont admis ; titulaire/conjoint/famille du chef ambigu, étranger, dupliqué ou mal formé provoque 409 ou 404 avant effet. Le refus accepte les demandes SUBMIT ou VALIDE et enregistre conditionnellement l’état natif REJECTED, qui retire cette demande de l’appartenance validée au compte. Il conserve contactId et toutes les relations familiales CRM. Le pointeur CRM accountRole:MEMBER correspondant n’est nettoyé que si aucun autre titulaire/lien familial actuellement validé n’en dépend ; SELF ou le pointeur d’un autre compte reste conservé. Aucune suppression de contact/demande, révocation de session ni email. Une demande déjà REJECTED nécessite la clé de décision d’origine pour rejouer son résultat initial. Après la seconde admission, le garde commun des mutations externes vérifie les ressources exactes réadmises avant tout propriétaire ou CAS inline. CONTACT_MUTATION_BLOCKED ou CONTACT_MUTATION_FENCE_UNAVAILABLE enregistre NOT_APPLIED avant effet ; le rejeu ne réessaie pas cette intention refusée. Si le résultat du propriétaire et le journal terminal ont été positivement confirmés dans la requête courante, un échec du nettoyage des verrous conserve APPLIED avec reason MEMBER_DECISION_CLEANUP_UNCONFIRMED ; les verrous peuvent rester, sans autoriser une nouvelle commande. Un rejeu ultérieur avec verrous conservés reste UNKNOWN sans preuve durable fraîche de confirmation terminale.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "members:reject",
  "additional": [
    "members:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat enregistré : examiner APPLIED, NOT_APPLIED ou UNKNOWN avant de conclure à une modification d’accès.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "replayed",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/MemberFamilyDecision"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_DECISION, INVALID_MEMBER_QUERY ou INVALID_MEMBER_ID : fournir uniquement les arguments exacts déclarés de la commande.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT ou CAMPAIGN_RESTRICTED_KEY : aucune donnée de compte n’a été renvoyée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND : compte ou référence actuellement inadmissible. Une réponse perdue ou un échec de postlecture ne doit pas déclencher une nouvelle identité de décision.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "MEMBER_REVISION_CONFLICT, AMBIGUOUS_MEMBER_IDENTITY, MEMBER_APPROVAL_PRECONDITION, MEMBER_REJECTION_PRECONDITION, MEMBER_REBIND_UNAVAILABLE, MEMBER_TARGET_CONFLICT, MEMBER_IDEMPOTENCY_CONFLICT, MEMBER_DECISION_IN_PROGRESS, MEMBER_FAMILY_CONFLICT, MEMBER_FAMILY_LIMIT ou INVALID_MEMBER_HISTORY : examiner le motif exact ; ne jamais contourner une décision en cours ou inconnue avec une autre clé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_DECISION_UNAVAILABLE : aucun résultat confirmé disponible. Conserver idempotencyKey et l’intention d’origine, consulter l’état courant et ne rejouer que cette même intention ; ne jamais en déduire une absence d’effet.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:reject",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-additional-scopes": [
    "members:read"
  ]
}
```

## Schémas

```json
{
  "components": {
    "schemas": {
      "MemberCapabilities": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "resource",
          "accountsRead",
          "familyRequestsRead",
          "decisions",
          "memberApplication"
        ],
        "properties": {
          "resource": {
            "type": "string",
            "enum": [
              "MEMBER_ACCOUNT_SPACE"
            ]
          },
          "accountsRead": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "familyRequestsRead": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "decisions": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "supported",
              "actions",
              "existingContactRequired",
              "familyApproval",
              "familyRejection"
            ],
            "properties": {
              "supported": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "actions": {
                "type": "array",
                "minItems": 4,
                "maxItems": 4,
                "uniqueItems": true,
                "items": {
                  "type": "string",
                  "enum": [
                    "APPROVE_ACCOUNT",
                    "REJECT_ACCOUNT",
                    "APPROVE_FAMILY_MEMBER",
                    "REJECT_FAMILY_MEMBER"
                  ]
                }
              },
              "existingContactRequired": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "familyApproval": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "familyRejection": {
                "type": "boolean",
                "enum": [
                  true
                ]
              }
            }
          },
          "memberApplication": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "supported",
              "reason"
            ],
            "properties": {
              "supported": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "reason": {
                "type": "string",
                "enum": [
                  "DEFERRED_BY_PRODUCT_DECISION"
                ]
              }
            }
          }
        }
      },
      "MemberAccount": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "kind",
          "revision",
          "state",
          "email",
          "emailVerified",
          "active",
          "profile",
          "linkedContactId",
          "createdAt",
          "validatedAt",
          "rejectedAt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "kind": {
            "type": "string",
            "enum": [
              "MEMBER_ACCOUNT"
            ]
          },
          "revision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "state": {
            "type": "string",
            "enum": [
              "SUBMIT",
              "VALIDE",
              "REJECTED"
            ]
          },
          "email": {
            "type": "string",
            "nullable": true
          },
          "emailVerified": {
            "type": "boolean",
            "nullable": true
          },
          "active": {
            "type": "boolean",
            "nullable": true
          },
          "profile": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "firstName",
              "lastName",
              "email",
              "phone"
            ],
            "properties": {
              "firstName": {
                "type": "string",
                "nullable": true
              },
              "lastName": {
                "type": "string",
                "nullable": true
              },
              "email": {
                "type": "string",
                "nullable": true
              },
              "phone": {
                "type": "string",
                "nullable": true
              }
            }
          },
          "linkedContactId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "validatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "rejectedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      },
      "MemberFamilyRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "kind",
          "accountId",
          "revision",
          "relatedContactIds",
          "state",
          "relationship",
          "hasContactMeans",
          "profile",
          "linkedContactId",
          "createdAt",
          "validatedAt",
          "rejectedAt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "kind": {
            "type": "string",
            "enum": [
              "ACCOUNT_FAMILY_MEMBER"
            ]
          },
          "accountId": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "relatedContactIds": {
            "type": "array",
            "maxItems": 2,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "state": {
            "type": "string",
            "enum": [
              "SUBMIT",
              "VALIDE",
              "REJECTED"
            ]
          },
          "relationship": {
            "type": "string",
            "enum": [
              "CONJOINT",
              "ENFANT"
            ]
          },
          "hasContactMeans": {
            "type": "boolean",
            "nullable": true
          },
          "profile": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "firstName",
              "lastName",
              "email",
              "phone"
            ],
            "properties": {
              "firstName": {
                "type": "string",
                "nullable": true
              },
              "lastName": {
                "type": "string",
                "nullable": true
              },
              "email": {
                "type": "string",
                "nullable": true
              },
              "phone": {
                "type": "string",
                "nullable": true
              }
            }
          },
          "linkedContactId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "validatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "rejectedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      },
      "MemberDecision": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "accountId",
          "action",
          "status",
          "reason",
          "admittedRevision",
          "resultRevision",
          "concurrentInternalChangesPossible",
          "crmSynchronization",
          "account"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "accountId": {
            "type": "string",
            "format": "uuid"
          },
          "action": {
            "type": "string",
            "enum": [
              "APPROVE",
              "REJECT"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "APPLIED",
              "NOT_APPLIED",
              "UNKNOWN"
            ]
          },
          "reason": {
            "type": "string",
            "nullable": true
          },
          "admittedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "resultRevision": {
            "type": "string",
            "nullable": true,
            "pattern": "^[a-f0-9]{64}$"
          },
          "concurrentInternalChangesPossible": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "crmSynchronization": {
            "type": "string",
            "enum": [
              "NOT_VERIFIED"
            ]
          },
          "account": {
            "$ref": "#/components/schemas/MemberAccount"
          }
        }
      },
      "MemberFamilyDecision": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "accountId",
          "action",
          "status",
          "reason",
          "admittedRevision",
          "resultRevision",
          "concurrentInternalChangesPossible",
          "crmSynchronization",
          "requestId",
          "familyRequest"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "accountId": {
            "type": "string",
            "format": "uuid"
          },
          "action": {
            "type": "string",
            "enum": [
              "APPROVE",
              "REJECT"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "APPLIED",
              "NOT_APPLIED",
              "UNKNOWN"
            ]
          },
          "reason": {
            "type": "string",
            "nullable": true
          },
          "admittedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "resultRevision": {
            "type": "string",
            "nullable": true,
            "pattern": "^[a-f0-9]{64}$"
          },
          "concurrentInternalChangesPossible": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "crmSynchronization": {
            "type": "string",
            "enum": [
              "NOT_VERIFIED"
            ]
          },
          "requestId": {
            "type": "string",
            "format": "uuid"
          },
          "familyRequest": {
            "$ref": "#/components/schemas/MemberFamilyRequest"
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
