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

# Insight

OpenAPI 3.0.3 · API 2.0.0

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

## Opérations

## GET /insight/context

Lire le cadre Insight de l’utilisateur ayant donné son consentement

`get_insight_context`

OAuth uniquement avec un consentement Insight personnel, explicite et récent. Les clés manuelles, root/système, les anciens OAuth et les autorisations de suggestions de contacts sont refusés, y compris pour les administrateurs. Ne jamais fournir actor, owner ou organisation : le serveur associe l’utilisateur ayant consenti et son organisation. Les contraintes privées et les enrichissements restent privés pour cet utilisateur. Le jeton, le consentement, les scopes et les droits natifs actuels sont relus avant l’entrée et la publication. I1 ne lit aucune source CRM et ne requiert aucun scope de source CRM. GET est passif et ne lance jamais d’analyse, d’activation ni de notification. Les champs inconnus sont refusés.

Renvoie la mission/le contexte communs, le cadre personnel de cet utilisateur, l’autorisation de modifier le cadre commun et l’état d’intégration. local/global est une préférence de population déclarée, jamais une autorisation d’accès. La confirmation n’active pas Insight ; l’activation attend le premier bilan qualifié.

### Authentification

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

### Permissions requises

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

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé qualifié.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightContextResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

### OpenAPI

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

## POST /insight/context/common

Mettre à jour le cadre Insight commun

`update_insight_common_context`

OAuth uniquement avec un consentement Insight personnel, explicite et récent. Les clés manuelles, root/système, les anciens OAuth et les autorisations de suggestions de contacts sont refusés, y compris pour les administrateurs. Ne jamais fournir actor, owner ou organisation : le serveur associe l’utilisateur ayant consenti et son organisation. Les contraintes privées et les enrichissements restent privés pour cet utilisateur. Le jeton, le consentement, les scopes et les droits natifs actuels sont relus avant l’entrée et la publication. I1 ne lit aucune source CRM et ne requiert aucun scope de source CRM. GET est passif et ne lance jamais d’analyse, d’activation ni de notification. Les champs inconnus sont refusés.

Lire d’abord la révision actuelle ; expectedRevision correspond exactement à la révision modifiée, ou à 0 si le cadre est absent. Seuls les champs fournis dans le patch changent ; les champs omis conservent leur valeur. Conserver l’UUID operationKey pour cette intention exacte lors des reprises. En cas de conflit, relire et réconcilier délibérément. Le reçu ne contient aucun texte de contexte. Avec insight:configure seul, récupérer le reçu en rejouant exactement la même charge de commande, operationKey et expectedRevision ; le point de terminaison GET du reçu exige séparément insight:read.

Droits ADMIN natifs actuels requis. Fournir au moins mission ou context ; mission doit contenir du texte non blanc ; context peut être effacé.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:configure",
  "additional": []
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "mission": {
            "type": "string",
            "minLength": 1,
            "maxLength": 8000,
            "pattern": "\\S"
          },
          "context": {
            "type": "string",
            "maxLength": 16000
          }
        },
        "required": [
          "operationKey",
          "expectedRevision"
        ],
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "mission"
            ]
          },
          {
            "required": [
              "context"
            ]
          }
        ]
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé qualifié.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

### OpenAPI

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

## POST /insight/context/personal

Mettre à jour le cadre Insight personnel de l’utilisateur ayant donné son consentement

`update_insight_personal_context`

OAuth uniquement avec un consentement Insight personnel, explicite et récent. Les clés manuelles, root/système, les anciens OAuth et les autorisations de suggestions de contacts sont refusés, y compris pour les administrateurs. Ne jamais fournir actor, owner ou organisation : le serveur associe l’utilisateur ayant consenti et son organisation. Les contraintes privées et les enrichissements restent privés pour cet utilisateur. Le jeton, le consentement, les scopes et les droits natifs actuels sont relus avant l’entrée et la publication. I1 ne lit aucune source CRM et ne requiert aucun scope de source CRM. GET est passif et ne lance jamais d’analyse, d’activation ni de notification. Les champs inconnus sont refusés.

Lire d’abord la révision actuelle ; expectedRevision correspond exactement à la révision modifiée, ou à 0 si le cadre est absent. Seuls les champs fournis dans le patch changent ; les champs omis conservent leur valeur. Conserver l’UUID operationKey pour cette intention exacte lors des reprises. En cas de conflit, relire et réconcilier délibérément. Le reçu ne contient aucun texte de contexte. Avec insight:configure seul, récupérer le reçu en rejouant exactement la même charge de commande, operationKey et expectedRevision ; le point de terminaison GET du reçu exige séparément insight:read.

Fournir au moins un champ personnel. primaryPriority=null l’efface dans un brouillon non confirmé ; un cadre confirmé doit conserver un public et une priorité principale ; dueOn est une date civile YYYY-MM-DD ou null. Les priorités secondaires ne remplacent jamais la priorité principale requise. Les contraintes et l’enrichissement sont facultatifs et privés. Utiliser cette commande pour enregistrer les réponses d’intégration avant confirmation.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:configure",
  "additional": []
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_86acc4db603dce0726a0"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé qualifié.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

### OpenAPI

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

## GET /insight/onboarding

Lire l’état de préparation à l’intégration Insight

`get_insight_onboarding`

OAuth uniquement avec un consentement Insight personnel, explicite et récent. Les clés manuelles, root/système, les anciens OAuth et les autorisations de suggestions de contacts sont refusés, y compris pour les administrateurs. Ne jamais fournir actor, owner ou organisation : le serveur associe l’utilisateur ayant consenti et son organisation. Les contraintes privées et les enrichissements restent privés pour cet utilisateur. Le jeton, le consentement, les scopes et les droits natifs actuels sont relus avant l’entrée et la publication. I1 ne lit aucune source CRM et ne requiert aucun scope de source CRM. GET est passif et ne lance jamais d’analyse, d’activation ni de notification. Les champs inconnus sont refusés.

Renvoie uniquement l’état de préparation et les champs minimaux manquants. Les réponses facultatives ne sont jamais requises. Ne lance ni entretien ni calcul de bilan.

### Authentification

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

### Permissions requises

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

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé qualifié.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightOnboardingResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

### OpenAPI

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

## POST /insight/onboarding/confirmation

Confirmer le cadre Insight minimal

`confirm_insight_onboarding`

OAuth uniquement avec un consentement Insight personnel, explicite et récent. Les clés manuelles, root/système, les anciens OAuth et les autorisations de suggestions de contacts sont refusés, y compris pour les administrateurs. Ne jamais fournir actor, owner ou organisation : le serveur associe l’utilisateur ayant consenti et son organisation. Les contraintes privées et les enrichissements restent privés pour cet utilisateur. Le jeton, le consentement, les scopes et les droits natifs actuels sont relus avant l’entrée et la publication. I1 ne lit aucune source CRM et ne requiert aucun scope de source CRM. GET est passif et ne lance jamais d’analyse, d’activation ni de notification. Les champs inconnus sont refusés.

Lire d’abord la révision actuelle ; expectedRevision correspond exactement à la révision modifiée, ou à 0 si le cadre est absent. Seuls les champs fournis dans le patch changent ; les champs omis conservent leur valeur. Conserver l’UUID operationKey pour cette intention exacte lors des reprises. En cas de conflit, relire et réconcilier délibérément. Le reçu ne contient aucun texte de contexte. Avec insight:configure seul, récupérer le reçu en rejouant exactement la même charge de commande, operationKey et expectedRevision ; le point de terminaison GET du reçu exige séparément insight:read.

Enregistrer d’abord les réponses communes/personnelles, puis fournir expectedCommonRevision et la révision personnelle expectedRevision. Mission, public et priorité principale sont requis ; contraintes et enrichissement sont facultatifs. La confirmation crée un instantané privé versionné dont l’état reste awaiting_initial_report.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:configure",
  "additional": []
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "expectedCommonRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "operationKey",
          "expectedRevision",
          "expectedCommonRevision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé qualifié.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

### OpenAPI

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

## GET /insight/operations/{operationKey}

Récupérer le reçu exact d’une opération Insight

`get_insight_operation`

OAuth uniquement avec un consentement Insight personnel, explicite et récent. Les clés manuelles, root/système, les anciens OAuth et les autorisations de suggestions de contacts sont refusés, y compris pour les administrateurs. Ne jamais fournir actor, owner ou organisation : le serveur associe l’utilisateur ayant consenti et son organisation. Les contraintes privées et les enrichissements restent privés pour cet utilisateur. Le jeton, le consentement, les scopes et les droits natifs actuels sont relus avant l’entrée et la publication. I1 ne lit aucune source CRM et ne requiert aucun scope de source CRM. GET est passif et ne lance jamais d’analyse, d’activation ni de notification. Les champs inconnus sont refusés.

Sélectionner le périmètre commun ou personnel et le même operationKey que pour la commande. Ne lit que le reçu exact de cet utilisateur, y compris pour les commandes communes qu’il a rédigées. Aucun texte de contexte. Un reçu introuvable ne prouve pas qu’une écriture interrompue ne puisse pas encore aboutir ; conserver la clé.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "operationKey",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  }
}
```

```json
{
  "name": "scope",
  "in": "query",
  "required": true,
  "schema": {
    "type": "string",
    "enum": [
      "common",
      "personal"
    ]
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé qualifié.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée, droits/consentement révoqués, conflit de révision, minimum incomplet ou résultat indisponible. INSIGHT_COMMAND_UNCERTAIN signifie que l’écriture a peut-être été prise en compte : récupérer son reçu exact avant toute nouvelle tentative.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

### OpenAPI

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

## POST /insight/analyses

Demander une analyse Insight privée

`request_insight_analysis`

OAuth privé avec consentement humain uniquement ; les identifiants manuels/root/système et les anciennes autorisations Insight limitées au cadre sont refusés. Exige insight:read en plus du scope d’analyse de cette opération. Ne jamais fournir actor, organisation, sourcePolicy, grant ni familles de sources : le serveur admet la personne ayant consenti et réduit les sources avant toute lecture. Un résultat issu d’une vue plus large ne peut pas être récupéré en le filtrant. Le jeton, le consentement, les droits natifs, le cadre et les dépendances des sources sont relus ; les éléments inaccessibles/périmés ne sont pas publics. Tous les dérivés de l’analyse restent personnels, y compris les résumés fondés sur des contraintes privées. Les faits enregistrés, les interprétations et les propositions humaines sont distincts. Une inscription n’est pas une présence. Les sources inconnues/partielles ne valent pas zéro. Aucune action CRM autonome, aucun message, notification, webhook ni export. GET est passif et ne met jamais de travail en file ni n’appelle de modèle. Les champs inconnus sont refusés.

Met explicitement en file une analyse préparée et peut entraîner un coût de modèle. Enregistrer et confirmer d’abord le cadre minimal. Fournir les révisions communes et personnelles actuelles exactes. Si la langue est omise, la valeur par défaut est fr. acceptedAt/status=queued est un reçu d’acceptation immuable, jamais la preuve qu’un bilan est prêt. Réutiliser le même UUID operationKey, la même charge, les mêmes révisions et la même langue pour récupérer l’opération. insight:analyses:request et insight:read permettent de rejouer exactement la commande sans insight:analyses:read ; GET pour l’état/le résultat exige séparément insight:analyses:read. Un conflit nécessite une réconciliation délibérée.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:analyses:request",
  "additional": [
    "insight:read"
  ]
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedCommonRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "expectedPersonalRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "language": {
            "type": "string",
            "enum": [
              "fr",
              "en",
              "he",
              "de",
              "es",
              "gr",
              "ro"
            ],
            "description": "Langue de l’API : fr français, en anglais, he hébreu, de allemand, es espagnol, gr grec, ro roumain. Si la langue est omise, la valeur par défaut est fr."
          }
        },
        "required": [
          "operationKey",
          "expectedCommonRevision",
          "expectedPersonalRevision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat d’analyse privée qualifié ou reçu d’acceptation immuable.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:request",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/analyses/current

Lire l’analyse Insight privée actuelle

`get_current_insight_analysis`

OAuth privé avec consentement humain uniquement ; les identifiants manuels/root/système et les anciennes autorisations Insight limitées au cadre sont refusés. Exige insight:read en plus du scope d’analyse de cette opération. Ne jamais fournir actor, organisation, sourcePolicy, grant ni familles de sources : le serveur admet la personne ayant consenti et réduit les sources avant toute lecture. Un résultat issu d’une vue plus large ne peut pas être récupéré en le filtrant. Le jeton, le consentement, les droits natifs, le cadre et les dépendances des sources sont relus ; les éléments inaccessibles/périmés ne sont pas publics. Tous les dérivés de l’analyse restent personnels, y compris les résumés fondés sur des contraintes privées. Les faits enregistrés, les interprétations et les propositions humaines sont distincts. Une inscription n’est pas une présence. Les sources inconnues/partielles ne valent pas zéro. Aucune action CRM autonome, aucun message, notification, webhook ni export. GET est passif et ne met jamais de travail en file ni n’appelle de modèle. Les champs inconnus sont refusés.

Lit le dernier résultat admissible pour cette personne, cette langue et cette vue exacte des sources. missing/pending/failed/stale sont des états explicites, jamais un rapport vide réussi. Examiner la couverture et les réserves. Un résultat prêt peut contenir zéro sujet. Aucun repli vers une vue plus large ou celle d’une autre personne.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "language",
  "in": "query",
  "required": false,
  "schema": {
    "type": "string",
    "enum": [
      "fr",
      "en",
      "he",
      "de",
      "es",
      "gr",
      "ro"
    ],
    "description": "Langue de l’API : fr français, en anglais, he hébreu, de allemand, es espagnol, gr grec, ro roumain. Si la langue est omise, la valeur par défaut est fr."
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat d’analyse privée qualifié ou reçu d’acceptation immuable.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisStateResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/analyses/{id}

Lire l’état d’une analyse Insight privée

`get_insight_analysis`

OAuth privé avec consentement humain uniquement ; les identifiants manuels/root/système et les anciennes autorisations Insight limitées au cadre sont refusés. Exige insight:read en plus du scope d’analyse de cette opération. Ne jamais fournir actor, organisation, sourcePolicy, grant ni familles de sources : le serveur admet la personne ayant consenti et réduit les sources avant toute lecture. Un résultat issu d’une vue plus large ne peut pas être récupéré en le filtrant. Le jeton, le consentement, les droits natifs, le cadre et les dépendances des sources sont relus ; les éléments inaccessibles/périmés ne sont pas publics. Tous les dérivés de l’analyse restent personnels, y compris les résumés fondés sur des contraintes privées. Les faits enregistrés, les interprétations et les propositions humaines sont distincts. Une inscription n’est pas une présence. Les sources inconnues/partielles ne valent pas zéro. Aucune action CRM autonome, aucun message, notification, webhook ni export. GET est passif et ne met jamais de travail en file ni n’appelle de modèle. Les champs inconnus sont refusés.

L’identifiant opaque de tâche (job ID) fourni par le reçu d’acceptation ne donne aucun accès. queued/running ne signifie pas que le résultat est prêt. Un résultat prêt exige l’admission actuelle du cadre et des sources, ainsi que la vue exacte des sources. Le reçu d’acceptation reste queued même lorsque la tâche est prête.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat d’analyse privée qualifié ou reçu d’acceptation immuable.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisStateResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/topics

Lister les sujets de l’analyse Insight privée actuelle

`list_insight_topics`

OAuth privé avec consentement humain uniquement ; les identifiants manuels/root/système et les anciennes autorisations Insight limitées au cadre sont refusés. Exige insight:read en plus du scope d’analyse de cette opération. Ne jamais fournir actor, organisation, sourcePolicy, grant ni familles de sources : le serveur admet la personne ayant consenti et réduit les sources avant toute lecture. Un résultat issu d’une vue plus large ne peut pas être récupéré en le filtrant. Le jeton, le consentement, les droits natifs, le cadre et les dépendances des sources sont relus ; les éléments inaccessibles/périmés ne sont pas publics. Tous les dérivés de l’analyse restent personnels, y compris les résumés fondés sur des contraintes privées. Les faits enregistrés, les interprétations et les propositions humaines sont distincts. Une inscription n’est pas une présence. Les sources inconnues/partielles ne valent pas zéro. Aucune action CRM autonome, aucun message, notification, webhook ni export. GET est passif et ne met jamais de travail en file ni n’appelle de modèle. Les champs inconnus sont refusés.

Retourne au plus cinq sujets préparés courants et l’état du bilan. Aucune pagination historique ni total exhaustif des possibilités. Les propositions nécessitent une décision humaine. reviewAction, lorsqu’il existe, identifie séparément la revue serveur pour les retours personnels ; un appel/message proposé n’est jamais cette action. summary.mode=facts_only ne porte aucune recommandation de sujet courant ; admitted_topics résume uniquement les sujets admis.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "language",
  "in": "query",
  "required": false,
  "schema": {
    "type": "string",
    "enum": [
      "fr",
      "en",
      "he",
      "de",
      "es",
      "gr",
      "ro"
    ],
    "description": "Langue de l’API : fr français, en anglais, he hébreu, de allemand, es espagnol, gr grec, ro roumain. Si la langue est omise, la valeur par défaut est fr."
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat d’analyse privée qualifié ou reçu d’acceptation immuable.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisTopicsResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/topics/{id}

Lire un sujet Insight privé actuel

`get_insight_topic`

OAuth privé avec consentement humain uniquement ; les identifiants manuels/root/système et les anciennes autorisations Insight limitées au cadre sont refusés. Exige insight:read en plus du scope d’analyse de cette opération. Ne jamais fournir actor, organisation, sourcePolicy, grant ni familles de sources : le serveur admet la personne ayant consenti et réduit les sources avant toute lecture. Un résultat issu d’une vue plus large ne peut pas être récupéré en le filtrant. Le jeton, le consentement, les droits natifs, le cadre et les dépendances des sources sont relus ; les éléments inaccessibles/périmés ne sont pas publics. Tous les dérivés de l’analyse restent personnels, y compris les résumés fondés sur des contraintes privées. Les faits enregistrés, les interprétations et les propositions humaines sont distincts. Une inscription n’est pas une présence. Les sources inconnues/partielles ne valent pas zéro. Aucune action CRM autonome, aucun message, notification, webhook ni export. GET est passif et ne met jamais de travail en file ni n’appelle de modèle. Les champs inconnus sont refusés.

L’identifiant opaque du sujet (Topic ID) est limité à l’analyse courante admissible dans la langue sélectionnée. Les Evidence IDs renvoient à cette analyse ; utilisez son analysis ID et get_insight_evidence pour lire une citation actuellement admise. Cette opération ne lit pas de sources arbitraires.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 250
  }
}
```

```json
{
  "name": "language",
  "in": "query",
  "required": false,
  "schema": {
    "type": "string",
    "enum": [
      "fr",
      "en",
      "he",
      "de",
      "es",
      "gr",
      "ro"
    ],
    "description": "Langue de l’API : fr français, en anglais, he hébreu, de allemand, es espagnol, gr grec, ro roumain. Si la langue est omise, la valeur par défaut est fr."
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat d’analyse privée qualifié ou reçu d’acceptation immuable.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisTopicStateResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/analyses/{id}/evidence/{evidenceId}

Lire un élément de preuve Insight actuellement admis

`get_insight_evidence`

OAuth privé avec consentement humain uniquement ; les identifiants manuels/root/système et les anciennes autorisations Insight limitées au cadre sont refusés. Exige insight:read en plus du scope d’analyse de cette opération. Ne jamais fournir actor, organisation, sourcePolicy, grant ni familles de sources : le serveur admet la personne ayant consenti et réduit les sources avant toute lecture. Un résultat issu d’une vue plus large ne peut pas être récupéré en le filtrant. Le jeton, le consentement, les droits natifs, le cadre et les dépendances des sources sont relus ; les éléments inaccessibles/périmés ne sont pas publics. Tous les dérivés de l’analyse restent personnels, y compris les résumés fondés sur des contraintes privées. Les faits enregistrés, les interprétations et les propositions humaines sont distincts. Une inscription n’est pas une présence. Les sources inconnues/partielles ne valent pas zéro. Aucune action CRM autonome, aucun message, notification, webhook ni export. GET est passif et ne met jamais de travail en file ni n’appelle de modèle. Les champs inconnus sont refusés.

Lit un Evidence ID exact dans cette analyse prête et actuellement admissible. Une preuve inaccessible, périmée, appartenant à un autre propriétaire ou absente renvoie not found ; aucun sélecteur de collection ou de contact n’est accepté. Une donnée déclarée n’est pas observée indépendamment ; prepared_suggestion ne signifie pas qu’une action a été réalisée. occurredOn est une date civile, pas un instant ; utilisez datePrecision.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

```json
{
  "name": "evidenceId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 200
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat d’analyse privée qualifié ou reçu d’acceptation immuable.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisEvidenceResultResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/onboarding/preparation

Lire les faits admis pour l’intégration Insight

`get_insight_onboarding_preparation`

OAuth privé avec consentement humain uniquement ; les identifiants manuels/root/système et les anciennes autorisations Insight limitées au cadre sont refusés. Exige insight:read en plus du scope d’analyse de cette opération. Ne jamais fournir actor, organisation, sourcePolicy, grant ni familles de sources : le serveur admet la personne ayant consenti et réduit les sources avant toute lecture. Un résultat issu d’une vue plus large ne peut pas être récupéré en le filtrant. Le jeton, le consentement, les droits natifs, le cadre et les dépendances des sources sont relus ; les éléments inaccessibles/périmés ne sont pas publics. Tous les dérivés de l’analyse restent personnels, y compris les résumés fondés sur des contraintes privées. Les faits enregistrés, les interprétations et les propositions humaines sont distincts. Une inscription n’est pas une présence. Les sources inconnues/partielles ne valent pas zéro. Aucune action CRM autonome, aucun message, notification, webhook ni export. GET est passif et ne met jamais de travail en file ni n’appelle de modèle. Les champs inconnus sont refusés.

Lit au plus six observations factuelles actuellement admises pour aider la personne à préparer son cadre, même sans minimum confirmé. facts_only n’est ni un diagnostic ni une intention personnelle proposée. Aucun modèle, travail, bilan ni écriture n’est déclenché ; aucune contrainte de brouillon n’est transmise à un modèle. Lire les réponses déclarées via get_insight_context ; ces observations ne remplacent jamais une réponse confirmée par la personne. Couverture, réserves et population local/global restent explicites.

### Authentification

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

### Permissions requises

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

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat d’analyse privée qualifié ou reçu d’acceptation immuable.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisPreparationResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée générique, scope/consentement actuel manquant, cadre/vue des sources modifié, propriétaire introuvable ou indisponible. Une commande potentiellement prise en compte renvoie INSIGHT_ANALYSIS_COMMAND_UNCERTAIN ; conserver et rejouer exactement la même intention et la même clé au lieu d’en inventer une autre.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/feedback/actions/{actionId}

Lire les déclarations personnelles d’une action de revue serveur

`get_insight_action_feedback`

OAuth personnel explicitement consenti uniquement ; clés manuelles/root/système et anciens grants sans les scopes demandés refusés, même pour un administrateur. Chaque opération exige insight:read et insight:analyses:read ; les commandes exigent aussi le nouveau scope explicite insight:feedback:configure. Ne jamais fournir acteur, propriétaire, organisation, sourcePolicy, grant ou familles de sources. Jeton, consentement, propriétaire et périmètre sont réadmis. Les déclarations concernent uniquement le consentant. Aucun geste CRM, pause/score de suggestion, message, notification, webhook, modèle ou calcul. Les GET sont passifs.

Lit la révision et les déclarations de cette action. Aucun ancien titre de conseil généré, fait ou lien de preuve. subject est null ou le libellé courant d’un contact/événement/priorité réadmis par son propriétaire canonique, jamais un ancien conseil. Une source retirée ou corrigée peut rendre ce libellé indisponible. Sujet et commentaire sont admis séparément : le libellé peut être disponible tandis que le commentaire reste masqué. Un commentaire n’est rendu que sous admission courante ; sinon comment=null et contentState=redacted. Les métadonnées restent disponibles même si une ancienne preuve a disparu.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "actionId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 250
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées de déclaration personnelle qualifiée ou reçu exact d’opération ; aucun contenu historique des sources.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackStateResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 250000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/feedback/history

Lire l’historique des déclarations personnelles Insight

`list_insight_feedback_history`

OAuth personnel explicitement consenti uniquement ; clés manuelles/root/système et anciens grants sans les scopes demandés refusés, même pour un administrateur. Chaque opération exige insight:read et insight:analyses:read ; les commandes exigent aussi le nouveau scope explicite insight:feedback:configure. Ne jamais fournir acteur, propriétaire, organisation, sourcePolicy, grant ou familles de sources. Jeton, consentement, propriétaire et périmètre sont réadmis. Les déclarations concernent uniquement le consentant. Aucun geste CRM, pause/score de suggestion, message, notification, webhook, modèle ou calcul. Les GET sont passifs.

Pagination dynamique et bornée par updatedAt décroissant, puis par identifiant de document stable croissant (ID). Suivez nextCursor sans le modifier ; omettez-le pour la première page. Les mises à jour pendant la navigation peuvent déplacer des lignes : il ne s’agit pas d’un instantané transactionnel. Les commentaires dont la source n’est pas accessible sont masqués ; subject vaut null ou un libellé canonique de contact, d’événement ou de priorité réadmis actuellement, indépendamment de la disponibilité du commentaire. Les métadonnées historiques ne donnent jamais accès aux anciens conseils d’analyse. Si la réponse bornée ne tient pas, demandez une limite plus petite.

### Authentification

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

### Permissions requises

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

### Paramètres

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

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 1000
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées de déclaration personnelle qualifiée ou reçu exact d’opération ; aucun contenu historique des sources.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackHistoryResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 250000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/feedback/done

Déclarer comme effectuée une action de revue serveur

`declare_insight_action_reviewed`

OAuth personnel explicitement consenti uniquement ; clés manuelles/root/système et anciens grants sans les scopes demandés refusés, même pour un administrateur. Chaque opération exige insight:read et insight:analyses:read ; les commandes exigent aussi le nouveau scope explicite insight:feedback:configure. Ne jamais fournir acteur, propriétaire, organisation, sourcePolicy, grant ou familles de sources. Jeton, consentement, propriétaire et périmètre sont réadmis. Les déclarations concernent uniquement le consentant. Aucun geste CRM, pause/score de suggestion, message, notification, webhook, modèle ou calcul. Les GET sont passifs.

Utilisez reviewAction.id/actionId fourni par le serveur et les resultId/topicId exacts qui l’ont présenté, et non le texte libre de la proposition. Les actions serveur prises en charge sont review_documented_need (examiner un besoin documenté), review_event_fit (examiner la pertinence ou la préparation d’un événement) et reassess_priority (réévaluer la priorité déclarée). Un appel ou message proposé dans le texte du modèle n’est pas cette revue et ne peut pas être déclaré réalisé par ce point de terminaison. Lisez d’abord la révision des retours de l’action ; utilisez expectedRevision=0 uniquement si le document de retours est absent. Conservez operationKey (UUID), la charge utile exacte et expectedRevision lors des nouvelles tentatives. Si la réponse est incertaine, rejouez exactement la commande ou lisez son reçu ; n’inventez jamais une autre clé. Un conflit exige une réconciliation délibérée. Les actions supplémentaires review_recorded_exchange, review_recorded_resources et review_calendar_preparation permettent respectivement de relire les échanges enregistrés, les flux bruts admis et les préparatifs autour d’une échéance communautaire, sans exécuter d’action CRM. Les revues review_relationship_continuity et review_activity_history portent sur les traces relationnelles admises et la comparaison des activités d’un groupe explicite, sans réaliser d’action métier.

Enregistre uniquement la déclaration humaine selon laquelle cette revue ou réévaluation précise, créée par le serveur, a été effectuée. Cela ne prouve pas qu’un appel ou un message proposé a eu lieu, ne constitue pas une interaction terminée et ne signifie pas que tous les besoins d’un contact ont été traités.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:feedback:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "resultId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "topicId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "actionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          }
        },
        "required": [
          "operationKey",
          "expectedRevision",
          "resultId",
          "topicId",
          "actionId"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées de déclaration personnelle qualifiée ou reçu exact d’opération ; aucun contenu historique des sources.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:feedback:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 250000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## POST /insight/feedback/not-relevant

Déclarer personnellement une action de revue serveur non pertinente

`mark_insight_action_not_relevant`

OAuth personnel explicitement consenti uniquement ; clés manuelles/root/système et anciens grants sans les scopes demandés refusés, même pour un administrateur. Chaque opération exige insight:read et insight:analyses:read ; les commandes exigent aussi le nouveau scope explicite insight:feedback:configure. Ne jamais fournir acteur, propriétaire, organisation, sourcePolicy, grant ou familles de sources. Jeton, consentement, propriétaire et périmètre sont réadmis. Les déclarations concernent uniquement le consentant. Aucun geste CRM, pause/score de suggestion, message, notification, webhook, modèle ou calcul. Les GET sont passifs.

Utilisez reviewAction.id/actionId fourni par le serveur et les resultId/topicId exacts qui l’ont présenté, et non le texte libre de la proposition. Les actions serveur prises en charge sont review_documented_need (examiner un besoin documenté), review_event_fit (examiner la pertinence ou la préparation d’un événement) et reassess_priority (réévaluer la priorité déclarée). Un appel ou message proposé dans le texte du modèle n’est pas cette revue et ne peut pas être déclaré réalisé par ce point de terminaison. Lisez d’abord la révision des retours de l’action ; utilisez expectedRevision=0 uniquement si le document de retours est absent. Conservez operationKey (UUID), la charge utile exacte et expectedRevision lors des nouvelles tentatives. Si la réponse est incertaine, rejouez exactement la commande ou lisez son reçu ; n’inventez jamais une autre clé. Un conflit exige une réconciliation délibérée. Les actions supplémentaires review_recorded_exchange, review_recorded_resources et review_calendar_preparation permettent respectivement de relire les échanges enregistrés, les flux bruts admis et les préparatifs autour d’une échéance communautaire, sans exécuter d’action CRM. Les revues review_relationship_continuity et review_activity_history portent sur les traces relationnelles admises et la comparaison des activités d’un groupe explicite, sans réaliser d’action métier.

Enregistre un rejet personnel avec commentaire privé facultatif de 2000 caractères maximum. La présentation pertinente courante doit être admise. Ne supprime pas l’historique ni les autres déclarations.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:feedback:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "resultId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "topicId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "actionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "comment": {
            "type": "string",
            "minLength": 0,
            "maxLength": 2000
          }
        },
        "required": [
          "operationKey",
          "expectedRevision",
          "resultId",
          "topicId",
          "actionId"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées de déclaration personnelle qualifiée ou reçu exact d’opération ; aucun contenu historique des sources.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:feedback:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 250000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## POST /insight/feedback/deferrals

Reporter personnellement une action de revue serveur

`defer_insight_action_review`

OAuth personnel explicitement consenti uniquement ; clés manuelles/root/système et anciens grants sans les scopes demandés refusés, même pour un administrateur. Chaque opération exige insight:read et insight:analyses:read ; les commandes exigent aussi le nouveau scope explicite insight:feedback:configure. Ne jamais fournir acteur, propriétaire, organisation, sourcePolicy, grant ou familles de sources. Jeton, consentement, propriétaire et périmètre sont réadmis. Les déclarations concernent uniquement le consentant. Aucun geste CRM, pause/score de suggestion, message, notification, webhook, modèle ou calcul. Les GET sont passifs.

Utilisez reviewAction.id/actionId fourni par le serveur et les resultId/topicId exacts qui l’ont présenté, et non le texte libre de la proposition. Les actions serveur prises en charge sont review_documented_need (examiner un besoin documenté), review_event_fit (examiner la pertinence ou la préparation d’un événement) et reassess_priority (réévaluer la priorité déclarée). Un appel ou message proposé dans le texte du modèle n’est pas cette revue et ne peut pas être déclaré réalisé par ce point de terminaison. Lisez d’abord la révision des retours de l’action ; utilisez expectedRevision=0 uniquement si le document de retours est absent. Conservez operationKey (UUID), la charge utile exacte et expectedRevision lors des nouvelles tentatives. Si la réponse est incertaine, rejouez exactement la commande ou lisez son reçu ; n’inventez jamais une autre clé. Un conflit exige une réconciliation délibérée. Les actions supplémentaires review_recorded_exchange, review_recorded_resources et review_calendar_preparation permettent respectivement de relire les échanges enregistrés, les flux bruts admis et les préparatifs autour d’une échéance communautaire, sans exécuter d’action CRM. Les revues review_relationship_continuity et review_activity_history portent sur les traces relationnelles admises et la comparaison des activités d’un groupe explicite, sans réaliser d’action métier.

Fournissez dueOn (date civile YYYY-MM-DD) et un timeZone IANA valide explicite. Le report commence à être réexaminé au premier instant de ce jour local, et non à la fin de la journée. Pour une nouvelle déclaration, choisissez un jour local strictement futur ; son premier instant doit encore se situer dans le futur lors de l’admission finale précédant l’écriture. Un reçu exact peut toujours être récupéré après expiration. Aucun rappel CRM n’est créé et aucun ancien conseil n’est automatiquement republié à l’expiration. Un fait nouvellement urgent peut être évalué indépendamment sans annuler ce report.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:feedback:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_c7980fb3ed49b957c11a"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées de déclaration personnelle qualifiée ou reçu exact d’opération ; aucun contenu historique des sources.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:feedback:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 250000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## POST /insight/feedback/declarations/{declarationId}/undo

Annuler exactement une déclaration personnelle Insight

`undo_insight_feedback_declaration`

OAuth personnel explicitement consenti uniquement ; clés manuelles/root/système et anciens grants sans les scopes demandés refusés, même pour un administrateur. Chaque opération exige insight:read et insight:analyses:read ; les commandes exigent aussi le nouveau scope explicite insight:feedback:configure. Ne jamais fournir acteur, propriétaire, organisation, sourcePolicy, grant ou familles de sources. Jeton, consentement, propriétaire et périmètre sont réadmis. Les déclarations concernent uniquement le consentant. Aucun geste CRM, pause/score de suggestion, message, notification, webhook, modèle ou calcul. Les GET sont passifs.

Utilisez reviewAction.id/actionId fourni par le serveur et les resultId/topicId exacts qui l’ont présenté, et non le texte libre de la proposition. Les actions serveur prises en charge sont review_documented_need (examiner un besoin documenté), review_event_fit (examiner la pertinence ou la préparation d’un événement) et reassess_priority (réévaluer la priorité déclarée). Un appel ou message proposé dans le texte du modèle n’est pas cette revue et ne peut pas être déclaré réalisé par ce point de terminaison. Lisez d’abord la révision des retours de l’action ; utilisez expectedRevision=0 uniquement si le document de retours est absent. Conservez operationKey (UUID), la charge utile exacte et expectedRevision lors des nouvelles tentatives. Si la réponse est incertaine, rejouez exactement la commande ou lisez son reçu ; n’inventez jamais une autre clé. Un conflit exige une réconciliation délibérée. Les actions supplémentaires review_recorded_exchange, review_recorded_resources et review_calendar_preparation permettent respectivement de relire les échanges enregistrés, les flux bruts admis et les préparatifs autour d’une échéance communautaire, sans exécuter d’action CRM. Les revues review_relationship_continuity et review_activity_history portent sur les traces relationnelles admises et la comparaison des activités d’un groupe explicite, sans réaliser d’action métier.

Annule uniquement cette declarationId sous la révision courante. Ne supprime aucun autre rejet/report et ne rétablit aucun accès révoqué. Propriété et consentement courants requis ; aucune ancienne preuve supprimée/illisible n’est exigée. Reçu métadonnées uniquement. Une nouvelle analyse admise reste nécessaire avant réapparition.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:feedback:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Paramètres

```json
{
  "name": "declarationId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "actionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          }
        },
        "required": [
          "operationKey",
          "expectedRevision",
          "actionId"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées de déclaration personnelle qualifiée ou reçu exact d’opération ; aucun contenu historique des sources.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:feedback:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 250000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/feedback/operations/{operationKey}

Récupérer un reçu exact de retours personnels

`get_insight_feedback_operation`

OAuth personnel explicitement consenti uniquement ; clés manuelles/root/système et anciens grants sans les scopes demandés refusés, même pour un administrateur. Chaque opération exige insight:read et insight:analyses:read ; les commandes exigent aussi le nouveau scope explicite insight:feedback:configure. Ne jamais fournir acteur, propriétaire, organisation, sourcePolicy, grant ou familles de sources. Jeton, consentement, propriétaire et périmètre sont réadmis. Les déclarations concernent uniquement le consentant. Aucun geste CRM, pause/score de suggestion, message, notification, webhook, modèle ou calcul. Les GET sont passifs.

Lit uniquement le reçu exact de l’opération de cette personne pour actionId et l’UUID operationKey d’origine. Aucune admission d’ancienne source ou présentation ni aucun contenu source n’est requis. Le reçu prouve cette intention, pas une action CRM. L’absence du reçu ne prouve pas qu’une commande interrompue ne peut pas encore aboutir.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "operationKey",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  }
}
```

```json
{
  "name": "actionId",
  "in": "query",
  "required": true,
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 250
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées de déclaration personnelle qualifiée ou reçu exact d’opération ; aucun contenu historique des sources.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée, de consentement/droits actuels, de présentation/révision en conflit, de déclaration manquante ou de propriétaire indisponible. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN signifie que la commande a peut-être été prise en compte : conserver l’intention/la clé exactes et récupérer son reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 250000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/webhooks

Créer une destination webhook Insight personnelle

`create_insight_webhook_destination`

Destinations Insight personnelles uniquement : jamais le système de webhooks wildcard de l’organisation. Chaque opération, y compris la lecture de métadonnées, exige un OAuth récent et explicitement consenti avec insight:webhooks:configure, ainsi que insight:read et insight:analyses:read. Les clés manual/root/system et les anciens grants sans ce scope sont refusés. Aucun droit de demander une analyse n’est implicite. Seuls cette personne et cette application/ressource OAuth peuvent gérer ses destinations ; les points de terminaison d’une autre connexion sont inaccessibles. ClientId, resource, sourceView et originRef sont calculés par le serveur et ne sont jamais acceptés comme arguments. Les URLs et secrets de signature sont des valeurs sensibles en écriture seule ; seul endpointOrigin peut être lu. Aucune opération de destination ne crée d’événement, ne met une livraison en file, n’envoie de requête de test ni n’effectue d’inférence. Un réglage actif est une configuration, pas la preuve que les ports de livraison sont qualifiés ni qu’un message a été envoyé. Le consentement et les droits actuels sont relus avant les effets et la publication. Les champs inconnus sont refusés.

Conservez exactement l’UUID operationKey, expectedRevision et la charge utile lors des nouvelles tentatives. expectedRevision correspond exactement à la révision actuellement lue. En cas d’incertitude, récupérez le reçu de l’opération d’origine ou rejouez exactement la même commande ; ne créez jamais automatiquement une autre clé. Un conflit exige une réconciliation délibérée.

La création explicite configure active=true et exige expectedRevision=0, une URL HTTPS et un signingSecret base64url robuste. La destination est liée à l’application/ressource, à l’origine de consentement et au périmètre admis exacts. Configuration uniquement : aucun événement ni envoi réseau. Des ports URL/coffre/transport qualifiés sont obligatoires ; leur absence renvoie 503.

Extension I5 : eventTypes est un choix fermé explicite. Une ancienne ligne et une création omise restent insight.analysis.ready uniquement ; une omission en modification conserve le choix. Ajouter insight.weekly.ready exige insight:weekly:read courant en plus des droits de gestion. Retirer ce type ou désactiver reste possible sous les droits de gestion actuels. L’origine et le périmètre de remise ne sont jamais renouvelés par cette modification ; si l’origine ancienne n’a plus les droits requis, créer une nouvelle destination admissible pour rétablir une remise. Le payload hebdomadaire ne contient que eventId/kind/time/reportId/reportVersion/occurrenceId/link relatif exact, sans texte de bilan. kind=weekly.ready ; le type d’abonnement est insight.weekly.ready. Les deux kinds historiques analysis.ready/analysis.updated gardent leur contrat sous insight.analysis.ready. Aucune requête GET ne publie ou livre.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:webhooks:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_95afed61f212b9c25f46"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées qualifiées ou reçu immuable uniquement ; aucun chemin d’URL, paramètre de requête, secret de signature, grant ni politique de source.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:webhooks:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/webhooks

Lister les destinations Insight personnelles de cette application

`list_insight_webhook_destinations`

Destinations Insight personnelles uniquement : jamais le système de webhooks wildcard de l’organisation. Chaque opération, y compris la lecture de métadonnées, exige un OAuth récent et explicitement consenti avec insight:webhooks:configure, ainsi que insight:read et insight:analyses:read. Les clés manual/root/system et les anciens grants sans ce scope sont refusés. Aucun droit de demander une analyse n’est implicite. Seuls cette personne et cette application/ressource OAuth peuvent gérer ses destinations ; les points de terminaison d’une autre connexion sont inaccessibles. ClientId, resource, sourceView et originRef sont calculés par le serveur et ne sont jamais acceptés comme arguments. Les URLs et secrets de signature sont des valeurs sensibles en écriture seule ; seul endpointOrigin peut être lu. Aucune opération de destination ne crée d’événement, ne met une livraison en file, n’envoie de requête de test ni n’effectue d’inférence. Un réglage actif est une configuration, pas la preuve que les ports de livraison sont qualifiés ni qu’un message a été envoyé. Le consentement et les droits actuels sont relus avant les effets et la publication. Les champs inconnus sont refusés.

Pagination vivante bornée de métadonnées, limit de 1 à 50. Réutiliser nextCursor sans modification. Le serveur filtre acteur, application et ressource avant lecture. Aucune destination d’une autre connexion. Une modification peut déplacer une ligne.

Extension I5 : eventTypes est un choix fermé explicite. Une ancienne ligne et une création omise restent insight.analysis.ready uniquement ; une omission en modification conserve le choix. Ajouter insight.weekly.ready exige insight:weekly:read courant en plus des droits de gestion. Retirer ce type ou désactiver reste possible sous les droits de gestion actuels. L’origine et le périmètre de remise ne sont jamais renouvelés par cette modification ; si l’origine ancienne n’a plus les droits requis, créer une nouvelle destination admissible pour rétablir une remise. Le payload hebdomadaire ne contient que eventId/kind/time/reportId/reportVersion/occurrenceId/link relatif exact, sans texte de bilan. kind=weekly.ready ; le type d’abonnement est insight.weekly.ready. Les deux kinds historiques analysis.ready/analysis.updated gardent leur contrat sous insight.analysis.ready. Aucune requête GET ne publie ou livre.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:webhooks:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Paramètres

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

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées qualifiées ou reçu immuable uniquement ; aucun chemin d’URL, paramètre de requête, secret de signature, grant ni politique de source.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookListResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:webhooks:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/webhooks/{destinationId}

Lire les métadonnées d’une destination Insight personnelle

`get_insight_webhook_destination`

Destinations Insight personnelles uniquement : jamais le système de webhooks wildcard de l’organisation. Chaque opération, y compris la lecture de métadonnées, exige un OAuth récent et explicitement consenti avec insight:webhooks:configure, ainsi que insight:read et insight:analyses:read. Les clés manual/root/system et les anciens grants sans ce scope sont refusés. Aucun droit de demander une analyse n’est implicite. Seuls cette personne et cette application/ressource OAuth peuvent gérer ses destinations ; les points de terminaison d’une autre connexion sont inaccessibles. ClientId, resource, sourceView et originRef sont calculés par le serveur et ne sont jamais acceptés comme arguments. Les URLs et secrets de signature sont des valeurs sensibles en écriture seule ; seul endpointOrigin peut être lu. Aucune opération de destination ne crée d’événement, ne met une livraison en file, n’envoie de requête de test ni n’effectue d’inférence. Un réglage actif est une configuration, pas la preuve que les ports de livraison sont qualifiés ni qu’un message a été envoyé. Le consentement et les droits actuels sont relus avant les effets et la publication. Les champs inconnus sont refusés.

L’ID de destination opaque ne donne jamais accès. Un grant de gestion actuellement autorisé peut lire les métadonnées pour le même acteur/application/ressource après la révocation d’une ancienne clé ou d’une vue de sources. Cela n’autorise pas les livraisons et ne permet pas de récupérer l’ancien secret ni l’URL de callback complète.

Extension I5 : eventTypes est un choix fermé explicite. Une ancienne ligne et une création omise restent insight.analysis.ready uniquement ; une omission en modification conserve le choix. Ajouter insight.weekly.ready exige insight:weekly:read courant en plus des droits de gestion. Retirer ce type ou désactiver reste possible sous les droits de gestion actuels. L’origine et le périmètre de remise ne sont jamais renouvelés par cette modification ; si l’origine ancienne n’a plus les droits requis, créer une nouvelle destination admissible pour rétablir une remise. Le payload hebdomadaire ne contient que eventId/kind/time/reportId/reportVersion/occurrenceId/link relatif exact, sans texte de bilan. kind=weekly.ready ; le type d’abonnement est insight.weekly.ready. Les deux kinds historiques analysis.ready/analysis.updated gardent leur contrat sous insight.analysis.ready. Aucune requête GET ne publie ou livre.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:webhooks:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Paramètres

```json
{
  "name": "destinationId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées qualifiées ou reçu immuable uniquement ; aucun chemin d’URL, paramètre de requête, secret de signature, grant ni politique de source.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookDestinationResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:webhooks:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/webhooks/{destinationId}

Mettre à jour la configuration d’une destination Insight personnelle

`update_insight_webhook_destination`

Destinations Insight personnelles uniquement : jamais le système de webhooks wildcard de l’organisation. Chaque opération, y compris la lecture de métadonnées, exige un OAuth récent et explicitement consenti avec insight:webhooks:configure, ainsi que insight:read et insight:analyses:read. Les clés manual/root/system et les anciens grants sans ce scope sont refusés. Aucun droit de demander une analyse n’est implicite. Seuls cette personne et cette application/ressource OAuth peuvent gérer ses destinations ; les points de terminaison d’une autre connexion sont inaccessibles. ClientId, resource, sourceView et originRef sont calculés par le serveur et ne sont jamais acceptés comme arguments. Les URLs et secrets de signature sont des valeurs sensibles en écriture seule ; seul endpointOrigin peut être lu. Aucune opération de destination ne crée d’événement, ne met une livraison en file, n’envoie de requête de test ni n’effectue d’inférence. Un réglage actif est une configuration, pas la preuve que les ports de livraison sont qualifiés ni qu’un message a été envoyé. Le consentement et les droits actuels sont relus avant les effets et la publication. Les champs inconnus sont refusés.

Conservez exactement l’UUID operationKey, expectedRevision et la charge utile lors des nouvelles tentatives. expectedRevision correspond exactement à la révision actuellement lue. En cas d’incertitude, récupérez le reçu de l’opération d’origine ou rejouez exactement la même commande ; ne créez jamais automatiquement une autre clé. Un conflit exige une réconciliation délibérée.

Modifier au moins url, signingSecret, active ou eventTypes ; les omissions conservent les valeurs. Identité, origine de consentement et périmètre ne sont pas modifiables par le client. La gestion avec un nouveau grant ne réautorise aucune remise liée à une origine/périmètre révoqué. active=true modifie uniquement la configuration.

Extension I5 : eventTypes est un choix fermé explicite. Une ancienne ligne et une création omise restent insight.analysis.ready uniquement ; une omission en modification conserve le choix. Ajouter insight.weekly.ready exige insight:weekly:read courant en plus des droits de gestion. Retirer ce type ou désactiver reste possible sous les droits de gestion actuels. L’origine et le périmètre de remise ne sont jamais renouvelés par cette modification ; si l’origine ancienne n’a plus les droits requis, créer une nouvelle destination admissible pour rétablir une remise. Le payload hebdomadaire ne contient que eventId/kind/time/reportId/reportVersion/occurrenceId/link relatif exact, sans texte de bilan. kind=weekly.ready ; le type d’abonnement est insight.weekly.ready. Les deux kinds historiques analysis.ready/analysis.updated gardent leur contrat sous insight.analysis.ready. Aucune requête GET ne publie ou livre.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:webhooks:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Paramètres

```json
{
  "name": "destinationId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_3e0880e63a0e8aadb9d7"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées qualifiées ou reçu immuable uniquement ; aucun chemin d’URL, paramètre de requête, secret de signature, grant ni politique de source.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:webhooks:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## POST /insight/webhooks/{destinationId}/disable

Désactiver une destination Insight personnelle

`disable_insight_webhook_destination`

Destinations Insight personnelles uniquement : jamais le système de webhooks wildcard de l’organisation. Chaque opération, y compris la lecture de métadonnées, exige un OAuth récent et explicitement consenti avec insight:webhooks:configure, ainsi que insight:read et insight:analyses:read. Les clés manual/root/system et les anciens grants sans ce scope sont refusés. Aucun droit de demander une analyse n’est implicite. Seuls cette personne et cette application/ressource OAuth peuvent gérer ses destinations ; les points de terminaison d’une autre connexion sont inaccessibles. ClientId, resource, sourceView et originRef sont calculés par le serveur et ne sont jamais acceptés comme arguments. Les URLs et secrets de signature sont des valeurs sensibles en écriture seule ; seul endpointOrigin peut être lu. Aucune opération de destination ne crée d’événement, ne met une livraison en file, n’envoie de requête de test ni n’effectue d’inférence. Un réglage actif est une configuration, pas la preuve que les ports de livraison sont qualifiés ni qu’un message a été envoyé. Le consentement et les droits actuels sont relus avant les effets et la publication. Les champs inconnus sont refusés.

Conservez exactement l’UUID operationKey, expectedRevision et la charge utile lors des nouvelles tentatives. expectedRevision correspond exactement à la révision actuellement lue. En cas d’incertitude, récupérez le reçu de l’opération d’origine ou rejouez exactement la même commande ; ne créez jamais automatiquement une autre clé. Un conflit exige une réconciliation délibérée.

Désactive cette destination sous la révision attendue. La gestion courante reste possible si le grant ou le périmètre d’origine a été révoqué. Ne supprime aucune autre destination et ne réautorise aucune remise.

Extension I5 : eventTypes est un choix fermé explicite. Une ancienne ligne et une création omise restent insight.analysis.ready uniquement ; une omission en modification conserve le choix. Ajouter insight.weekly.ready exige insight:weekly:read courant en plus des droits de gestion. Retirer ce type ou désactiver reste possible sous les droits de gestion actuels. L’origine et le périmètre de remise ne sont jamais renouvelés par cette modification ; si l’origine ancienne n’a plus les droits requis, créer une nouvelle destination admissible pour rétablir une remise. Le payload hebdomadaire ne contient que eventId/kind/time/reportId/reportVersion/occurrenceId/link relatif exact, sans texte de bilan. kind=weekly.ready ; le type d’abonnement est insight.weekly.ready. Les deux kinds historiques analysis.ready/analysis.updated gardent leur contrat sous insight.analysis.ready. Aucune requête GET ne publie ou livre.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:webhooks:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Paramètres

```json
{
  "name": "destinationId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          }
        },
        "required": [
          "operationKey",
          "expectedRevision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées qualifiées ou reçu immuable uniquement ; aucun chemin d’URL, paramètre de requête, secret de signature, grant ni politique de source.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:webhooks:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/webhooks/{destinationId}/operations/{operationKey}

Récupérer le reçu exact d’une opération de destination personnelle

`get_insight_webhook_operation`

Destinations Insight personnelles uniquement : jamais le système de webhooks wildcard de l’organisation. Chaque opération, y compris la lecture de métadonnées, exige un OAuth récent et explicitement consenti avec insight:webhooks:configure, ainsi que insight:read et insight:analyses:read. Les clés manual/root/system et les anciens grants sans ce scope sont refusés. Aucun droit de demander une analyse n’est implicite. Seuls cette personne et cette application/ressource OAuth peuvent gérer ses destinations ; les points de terminaison d’une autre connexion sont inaccessibles. ClientId, resource, sourceView et originRef sont calculés par le serveur et ne sont jamais acceptés comme arguments. Les URLs et secrets de signature sont des valeurs sensibles en écriture seule ; seul endpointOrigin peut être lu. Aucune opération de destination ne crée d’événement, ne met une livraison en file, n’envoie de requête de test ni n’effectue d’inférence. Un réglage actif est une configuration, pas la preuve que les ports de livraison sont qualifiés ni qu’un message a été envoyé. Le consentement et les droits actuels sont relus avant les effets et la publication. Les champs inconnus sont refusés.

Lit le reçu exact de cet acteur/application/ressource pour l’UUID operationKey d’origine. Le reçu ne contient ni URL ni secret. L’absence du reçu ne prouve pas qu’une commande interrompue ne peut pas encore aboutir. Le consentement actuel de gestion est requis, mais l’ancienne admission des sources de livraison n’est pas rétablie.

Extension I5 : eventTypes est un choix fermé explicite. Une ancienne ligne et une création omise restent insight.analysis.ready uniquement ; une omission en modification conserve le choix. Ajouter insight.weekly.ready exige insight:weekly:read courant en plus des droits de gestion. Retirer ce type ou désactiver reste possible sous les droits de gestion actuels. L’origine et le périmètre de remise ne sont jamais renouvelés par cette modification ; si l’origine ancienne n’a plus les droits requis, créer une nouvelle destination admissible pour rétablir une remise. Le payload hebdomadaire ne contient que eventId/kind/time/reportId/reportVersion/occurrenceId/link relatif exact, sans texte de bilan. kind=weekly.ready ; le type d’abonnement est insight.weekly.ready. Les deux kinds historiques analysis.ready/analysis.updated gardent leur contrat sous insight.analysis.ready. Aucune requête GET ne publie ou livre.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:webhooks:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Paramètres

```json
{
  "name": "destinationId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

```json
{
  "name": "operationKey",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées qualifiées ou reçu immuable uniquement ; aucun chemin d’URL, paramètre de requête, secret de signature, grant ni politique de source.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Entrée refusée générique, consentement/propriété actuels, conflit de révision, élément introuvable ou ports qualifiés indisponibles. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN peut suivre la prise en compte : conserver la commande exacte et récupérer son reçu. Les secrets et chemins/paramètres d’URL n’apparaissent jamais dans les erreurs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:webhooks:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/preferences

Lire les préférences de rapport hebdomadaire personnelles

`get_insight_weekly_preferences`

OAuth personnel explicite uniquement avec insight:read et le nouveau scope hebdomadaire de cette opération. Anciens grants cadre/analyse/retours, clés manuelles/root/système et données d’autrui refusés. Lecture, demande et configuration des préférences sont distinctes ; aucune permission implicite de demander une analyse. Les familles de sources sont réduites côté serveur avant lecture puis réadmises. Ne jamais fournir acteur, organisation, sourcePolicy, preuve, capsule ou sélecteur de source. GET passifs : aucun travail, modèle, rendu, renouvellement ou envoi. I4 stocke deux choix distincts email/avis de disponibilité mais ne crée aucune remise expédiable, SMTP ou push ; I5 n’est pas actif.

Aucun jour, heure, fuseau ou langue inventé. schedule et language peuvent être null. emailEnabled et availabilityNoticeEnabled sont distincts et désactivés par défaut ; choisir un créneau n’active aucun des deux. Un choix true stocké ne prouve pas qu’une remise soit disponible.

### Authentification

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

### Permissions requises

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

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé qualifié du propriétaire ou reçu d’opération immuable ; aucune preuve/capsule brute ni autorité.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPreferencesResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/weekly/preferences

Enregistrer les préférences de rapport hebdomadaire personnelles

`update_insight_weekly_preferences`

OAuth personnel explicite uniquement avec insight:read et le nouveau scope hebdomadaire de cette opération. Anciens grants cadre/analyse/retours, clés manuelles/root/système et données d’autrui refusés. Lecture, demande et configuration des préférences sont distinctes ; aucune permission implicite de demander une analyse. Les familles de sources sont réduites côté serveur avant lecture puis réadmises. Ne jamais fournir acteur, organisation, sourcePolicy, preuve, capsule ou sélecteur de source. GET passifs : aucun travail, modèle, rendu, renouvellement ou envoi. I4 stocke deux choix distincts email/avis de disponibilité mais ne crée aucune remise expédiable, SMTP ou push ; I5 n’est pas actif.

Fournissez un UUID operationKey et l’exact expectedRevision lue dans les préférences (0 si elles sont absentes), ainsi qu’au moins un champ de patch. Les champs omis sont conservés. schedule est remplacé en entier par un tuple weekday/localTime/timeZone complet, ou par null ; il n’est jamais possible de modifier un seul champ du tuple. language accepte fr/en/he/de/es/gr/ro ou null. Le consentement explicite aux préférences autorise aussi l’enregistrement des deux opt-ins indépendants ; aucun des deux n’envoie quoi que ce soit dans I4. Conservez la charge utile, la clé et la révision exactes pour récupérer le reçu en rejouant la commande ; le GET du reçu exige séparément weekly:read.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:weekly:preferences:configure",
  "additional": [
    "insight:read"
  ]
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_225b2a9e388335330940"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé qualifié du propriétaire ou reçu d’opération immuable ; aucune preuve/capsule brute ni autorité.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPreferencesReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:preferences:configure",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/weekly/preferences/operations/{operationKey}

Récupérer un reçu exact de préférences hebdomadaires

`get_insight_weekly_preferences_operation`

OAuth personnel explicite uniquement avec insight:read et le nouveau scope hebdomadaire de cette opération. Anciens grants cadre/analyse/retours, clés manuelles/root/système et données d’autrui refusés. Lecture, demande et configuration des préférences sont distinctes ; aucune permission implicite de demander une analyse. Les familles de sources sont réduites côté serveur avant lecture puis réadmises. Ne jamais fournir acteur, organisation, sourcePolicy, preuve, capsule ou sélecteur de source. GET passifs : aucun travail, modèle, rendu, renouvellement ou envoi. I4 stocke deux choix distincts email/avis de disponibilité mais ne crée aucune remise expédiable, SMTP ou push ; I5 n’est pas actif.

Lit uniquement le reçu exact immuable du consentant. Il prouve l’acquisition de cette intention de préférence, pas un email, un avis ni des valeurs courantes inchangées. Une absence ne prouve pas qu’une sauvegarde interrompue ne terminera pas.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "operationKey",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé qualifié du propriétaire ou reçu d’opération immuable ; aucune preuve/capsule brute ni autorité.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPreferencesReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/weekly/reports

Demander une occurrence hebdomadaire personnelle exacte

`request_insight_weekly_report`

OAuth personnel explicite uniquement avec insight:read et le nouveau scope hebdomadaire de cette opération. Anciens grants cadre/analyse/retours, clés manuelles/root/système et données d’autrui refusés. Lecture, demande et configuration des préférences sont distinctes ; aucune permission implicite de demander une analyse. Les familles de sources sont réduites côté serveur avant lecture puis réadmises. Ne jamais fournir acteur, organisation, sourcePolicy, preuve, capsule ou sélecteur de source. GET passifs : aucun travail, modèle, rendu, renouvellement ou envoi. I4 stocke deux choix distincts email/avis de disponibilité mais ne crée aucune remise expédiable, SMTP ou push ; I5 n’est pas actif.

Lisez d’abord get_insight_weekly_status et utilisez son occurrenceId et sa preferenceRevision fournis par le serveur. Ne composez jamais un occurrence ID à partir d’une date supposée. Fournissez un UUID operationKey et expectedPreferenceRevision. Cela acquiert une préparation en file d’attente, et non un rapport prêt. Les demandes explicites peuvent préparer avant T−30 ; la publication attend l’instant planifié. La même intention et la même clé permettent de récupérer le reçu immuable même si les préférences changent ensuite. En cas d’incertitude, conservez la charge utile exacte. weekly:request avec insight:read permet de rejouer exactement la commande sans weekly:read ; le GET du reçu et la lecture du rapport exigent séparément weekly:read. Aucun email ni avis n’est envoyé.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:weekly:request",
  "additional": [
    "insight:read"
  ]
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedPreferenceRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740990
          },
          "occurrenceId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        },
        "required": [
          "operationKey",
          "expectedPreferenceRevision",
          "occurrenceId"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé qualifié du propriétaire ou reçu d’opération immuable ; aucune preuve/capsule brute ni autorité.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:request",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/weekly/reports

Lister les métadonnées des versions admises des rapports hebdomadaires

`list_insight_weekly_reports`

OAuth personnel explicite uniquement avec insight:read et le nouveau scope hebdomadaire de cette opération. Anciens grants cadre/analyse/retours, clés manuelles/root/système et données d’autrui refusés. Lecture, demande et configuration des préférences sont distinctes ; aucune permission implicite de demander une analyse. Les familles de sources sont réduites côté serveur avant lecture puis réadmises. Ne jamais fournir acteur, organisation, sourcePolicy, preuve, capsule ou sélecteur de source. GET passifs : aucun travail, modèle, rendu, renouvellement ou envoi. I4 stocke deux choix distincts email/avis de disponibilité mais ne crée aucune remise expédiable, SMTP ou push ; I5 n’est pas actif.

Pagination vivante bornée à 20 versions, propriétaire et vue exacts. Réutiliser nextCursor sans modification ; aucun instantané transactionnel. Les métadonnées ne réautorisent aucun ancien conseil ni une autre version. Aucune préparation ni reconstitution rétroactive.

### Authentification

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

### Permissions requises

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

### Paramètres

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

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 1500
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé qualifié du propriétaire ou reçu d’opération immuable ; aucune preuve/capsule brute ni autorité.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyListResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/status

Lire l’occurrence suivante ou sélectionnée d’un rapport hebdomadaire

`get_insight_weekly_status`

OAuth personnel explicite uniquement avec insight:read et le nouveau scope hebdomadaire de cette opération. Anciens grants cadre/analyse/retours, clés manuelles/root/système et données d’autrui refusés. Lecture, demande et configuration des préférences sont distinctes ; aucune permission implicite de demander une analyse. Les familles de sources sont réduites côté serveur avant lecture puis réadmises. Ne jamais fournir acteur, organisation, sourcePolicy, preuve, capsule ou sélecteur de source. GET passifs : aucun travail, modèle, rendu, renouvellement ou envoi. I4 stocke deux choix distincts email/avis de disponibilité mais ne crée aucune remise expédiable, SMTP ou push ; I5 n’est pas actif.

Omettez occurrenceId pour lire le prochain créneau théorique calculé par le serveur, ou transmettez un occurrenceId exact annoncé pour examiner un travail déjà acquis. Un planning, une langue ou un calendrier incomplet reste explicitement signalé. scheduled/queued/running/budget_waiting/prepared ne signifie pas que le résultat est prêt. La période est l’intervalle civil [from,to) enregistré, et non une semaine artificielle de 168 heures. Les heures inexistantes lors du passage à l’heure d’été (DST) sont ignorées ; en cas d’heure répétée, un seul instant qualifié est choisi. Ce GET n’acquiert jamais de préparation et ne modifie pas le calendrier.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "occurrenceId",
  "in": "query",
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé qualifié du propriétaire ou reçu d’opération immuable ; aucune preuve/capsule brute ni autorité.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyStatusResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/reports/{reportId}/versions/{reportVersion}

Lire une version historique précise d’un rapport hebdomadaire

`get_insight_weekly_report`

OAuth personnel explicite uniquement avec insight:read et le nouveau scope hebdomadaire de cette opération. Anciens grants cadre/analyse/retours, clés manuelles/root/système et données d’autrui refusés. Lecture, demande et configuration des préférences sont distinctes ; aucune permission implicite de demander une analyse. Les familles de sources sont réduites côté serveur avant lecture puis réadmises. Ne jamais fournir acteur, organisation, sourcePolicy, preuve, capsule ou sélecteur de source. GET passifs : aucun travail, modèle, rendu, renouvellement ou envoi. I4 stocke deux choix distincts email/avis de disponibilité mais ne crée aucune remise expédiable, SMTP ou push ; I5 n’est pas actif.

Sélectionner reportId et reportVersion exacts, sans substitution par le dernier bilan. L’ancien cadre est une déclaration datée, pas le cadre actuel. Preuves/vue/propriétaire courants requis ; source corrigée/révoquée = unavailable et result/frame null. Comparaison inconnue et couverture partielle explicites ; apparition dans les données ou priorité déclarée modifiée ne signifie aucun progrès humain/financier. Au plus trois évolutions et trois attentions, sans nombre imposé.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "reportId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

```json
{
  "name": "reportVersion",
  "in": "path",
  "required": true,
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 9007199254740990
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé qualifié du propriétaire ou reçu d’opération immuable ; aucune preuve/capsule brute ni autorité.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyReportResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/operations/{operationKey}

Récupérer le reçu exact d’une demande de rapport hebdomadaire

`get_insight_weekly_operation`

OAuth personnel explicite uniquement avec insight:read et le nouveau scope hebdomadaire de cette opération. Anciens grants cadre/analyse/retours, clés manuelles/root/système et données d’autrui refusés. Lecture, demande et configuration des préférences sont distinctes ; aucune permission implicite de demander une analyse. Les familles de sources sont réduites côté serveur avant lecture puis réadmises. Ne jamais fournir acteur, organisation, sourcePolicy, preuve, capsule ou sélecteur de source. GET passifs : aucun travail, modèle, rendu, renouvellement ou envoi. I4 stocke deux choix distincts email/avis de disponibilité mais ne crée aucune remise expédiable, SMTP ou push ; I5 n’est pas actif.

Utilise la clé UUID d’origine, le consentement personnel courant et la vue exacte courante. queued reste le statut immuable d’acquisition même après publication. Le reçu ne prouve ni email, PDF ni disponibilité des sources ; lire séparément le bilan/état exact.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "operationKey",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé qualifié du propriétaire ou reçu d’opération immuable ; aucune preuve/capsule brute ni autorité.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée, consentement actuel/admission actuelle des sources, conflit de révision, élément introuvable ou indisponibilité. Une commande éventuellement prise en compte renvoie INSIGHT_WEEKLY_COMMAND_UNCERTAIN ; récupérer ou rejouer l’intention/la clé d’origine exactes au lieu d’inventer un autre UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/weekly/documents

Préparer un PDF partageable d’une version précise d’un rapport hebdomadaire

`prepare_insight_weekly_document`

OAuth personnel avec insight:read et le scope documentaire explicite de cette opération. Anciens grants hebdo/analyse/cadre ne permettent pas automatiquement préparation, partage ou lecture documentaire. Un grant documentaire seul n’exige aucun weekly:read ni demande d’analyse implicite. Vue exacte, acteur et preuves de la version d’origine sont réadmis. Ne jamais fournir acteur, organisation, sourcePolicy, capsule, cadre brut, preuve, HTML ou URL publique. Projection shareable uniquement. Sa lignée indépendante omet contraintes/enrichissement/commentaires privés et ancienne prose personnelle ; omissions et couverture partielle restent visibles. Aucun remplacement silencieux d’une projection analytique indisponible par des faits seuls. Préparation/remise privée seulement, sans email, upload, notification ni partage natif. Une copie partagée manuellement est datée et non révocable à distance.

Fournissez un UUID operationKey ainsi que reportId, reportVersion et projection=shareable exacts. Cela acquiert un travail en file d’attente, pas un PDF prêt ; cette commande HTTP ne lance aucun moteur de rendu. En cas d’incertitude, conservez le même UUID et la charge utile exacte ; le rejeu récupère le reçu immuable sans second rendu. Un grant de préparation permet ce rejeu exact sans le scope séparé documents:read. Aucun abonnement ni partage humain n’est activé.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:documents:prepare",
  "additional": [
    "insight:read"
  ]
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "reportId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "reportVersion": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "projection": {
            "type": "string",
            "enum": [
              "shareable"
            ]
          }
        },
        "required": [
          "operationKey",
          "reportId",
          "reportVersion",
          "projection"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé exact du document qualifié ; aucune capsule/preuve brute des sources ni URL publique de téléchargement.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:documents:prepare",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 8388608
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/weekly/documents/{documentId}/status

Lire l’état de préparation d’un PDF hebdomadaire existant

`get_insight_weekly_document_status`

OAuth personnel avec insight:read et le scope documentaire explicite de cette opération. Anciens grants hebdo/analyse/cadre ne permettent pas automatiquement préparation, partage ou lecture documentaire. Un grant documentaire seul n’exige aucun weekly:read ni demande d’analyse implicite. Vue exacte, acteur et preuves de la version d’origine sont réadmis. Ne jamais fournir acteur, organisation, sourcePolicy, capsule, cadre brut, preuve, HTML ou URL publique. Projection shareable uniquement. Sa lignée indépendante omet contraintes/enrichissement/commentaires privés et ancienne prose personnelle ; omissions et couverture partielle restent visibles. Aucun remplacement silencieux d’une projection analytique indisponible par des faits seuls. Préparation/remise privée seulement, sans email, upload, notification ni partage natif. Une copie partagée manuellement est datée et non révocable à distance.

État passif queued/running/ready/refused/failed et empreintes. queued/running ne signifie pas un fichier prêt à partager. Glyphes, mise en page, Chromium ou sources non admises peuvent refuser la préparation ; ne pas fabriquer un PDF vide réussi.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "documentId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé exact du document qualifié ; aucune capsule/preuve brute des sources ni URL publique de téléchargement.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfMetadataResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:documents:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 8388608
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/documents/{documentId}/preview

Prévisualiser le contenu exact du PDF hebdomadaire partageable

`get_insight_weekly_document_preview`

OAuth personnel avec insight:read et le scope documentaire explicite de cette opération. Anciens grants hebdo/analyse/cadre ne permettent pas automatiquement préparation, partage ou lecture documentaire. Un grant documentaire seul n’exige aucun weekly:read ni demande d’analyse implicite. Vue exacte, acteur et preuves de la version d’origine sont réadmis. Ne jamais fournir acteur, organisation, sourcePolicy, capsule, cadre brut, preuve, HTML ou URL publique. Projection shareable uniquement. Sa lignée indépendante omet contraintes/enrichissement/commentaires privés et ancienne prose personnelle ; omissions et couverture partielle restent visibles. Aucun remplacement silencieux d’une projection analytique indisponible par des faits seuls. Préparation/remise privée seulement, sans email, upload, notification ni partage natif. Une copie partagée manuellement est datée et non révocable à distance.

Retourne la projection exacte stockée et admise, contentDigest, omissions et couverture ; aucune prose du résultat personnel ni octet PDF. Examiner cette version/projection exacte avant partage manuel. Un document queued peut déjà avoir son aperçu exact, sans octets prêts. Une source changée peut refuser aperçu et remise ultérieure.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "documentId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé exact du document qualifié ; aucune capsule/preuve brute des sources ni URL publique de téléchargement.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfPreviewResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:documents:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 8388608
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/documents/{documentId}

Lire les métadonnées exactes d’un PDF hebdomadaire

`get_insight_weekly_document_metadata`

OAuth personnel avec insight:read et le scope documentaire explicite de cette opération. Anciens grants hebdo/analyse/cadre ne permettent pas automatiquement préparation, partage ou lecture documentaire. Un grant documentaire seul n’exige aucun weekly:read ni demande d’analyse implicite. Vue exacte, acteur et preuves de la version d’origine sont réadmis. Ne jamais fournir acteur, organisation, sourcePolicy, capsule, cadre brut, preuve, HTML ou URL publique. Projection shareable uniquement. Sa lignée indépendante omet contraintes/enrichissement/commentaires privés et ancienne prose personnelle ; omissions et couverture partielle restent visibles. Aucun remplacement silencieux d’une projection analytique indisponible par des faits seuls. Préparation/remise privée seulement, sans email, upload, notification ni partage natif. Une copie partagée manuellement est datée et non révocable à distance.

Métadonnées/empreintes existantes seulement, sans génération, actualisation, prolongation ni octets. contentDigest identifie l’aperçu exact ; sha256 identifie les octets PDF décodés et constitue une autre valeur.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "documentId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé exact du document qualifié ; aucune capsule/preuve brute des sources ni URL publique de téléchargement.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfMetadataResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:documents:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 8388608
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/documents/{documentId}/content

Lire les octets privés bornés d’un PDF hebdomadaire existant

`get_insight_weekly_document_content`

OAuth personnel avec insight:read et le scope documentaire explicite de cette opération. Anciens grants hebdo/analyse/cadre ne permettent pas automatiquement préparation, partage ou lecture documentaire. Un grant documentaire seul n’exige aucun weekly:read ni demande d’analyse implicite. Vue exacte, acteur et preuves de la version d’origine sont réadmis. Ne jamais fournir acteur, organisation, sourcePolicy, capsule, cadre brut, preuve, HTML ou URL publique. Projection shareable uniquement. Sa lignée indépendante omet contraintes/enrichissement/commentaires privés et ancienne prose personnelle ; omissions et couverture partielle restent visibles. Aucun remplacement silencieux d’une projection analytique indisponible par des faits seuls. Préparation/remise privée seulement, sans email, upload, notification ni partage natif. Une copie partagée manuellement est datée et non révocable à distance.

Ne renvoie qu’un PDF déjà prêt, limité à 4 MiB décodés, sous forme de contenu JSON privé contentBase64 accompagné de MIME, filename, bytes et SHA-256. Décodez base64, puis vérifiez SHA-256 sur les octets du PDF décodé, et non sur la chaîne base64. Aucun ASSETS/URL publique, data URI, lien bearer ni récupération du fichier par le serveur n’est renvoyé ou inventé. Ce GET passif ne lance jamais le rendu et ne réessaie pas une préparation échouée. Toute copie téléchargée ou partagée est datée et ne peut pas être révoquée à distance.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "documentId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé exact du document qualifié ; aucune capsule/preuve brute des sources ni URL publique de téléchargement.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfContentResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:documents:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 8388608
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/documents/operations/{operationKey}

Récupérer le reçu exact de préparation d’un PDF hebdomadaire

`get_insight_weekly_document_operation`

OAuth personnel avec insight:read et le scope documentaire explicite de cette opération. Anciens grants hebdo/analyse/cadre ne permettent pas automatiquement préparation, partage ou lecture documentaire. Un grant documentaire seul n’exige aucun weekly:read ni demande d’analyse implicite. Vue exacte, acteur et preuves de la version d’origine sont réadmis. Ne jamais fournir acteur, organisation, sourcePolicy, capsule, cadre brut, preuve, HTML ou URL publique. Projection shareable uniquement. Sa lignée indépendante omet contraintes/enrichissement/commentaires privés et ancienne prose personnelle ; omissions et couverture partielle restent visibles. Aucun remplacement silencieux d’une projection analytique indisponible par des faits seuls. Préparation/remise privée seulement, sans email, upload, notification ni partage natif. Une copie partagée manuellement est datée et non révocable à distance.

operationKey d’origine et consentement personnel documents:read actuel. Le reçu associe documentId au rapport, à la version et à la projection partageable exacts ; il ne prouve ni que les octets sont prêts ni qu’un partage humain a eu lieu. L’absence du reçu ne prouve pas qu’une préparation interrompue ne peut pas encore aboutir.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "operationKey",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat privé exact du document qualifié ; aucune capsule/preuve brute des sources ni URL publique de téléchargement.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique d’entrée fermée, de consentement/admission actuelle des sources, de conflit, d’élément introuvable, de taille ou de moteur de rendu indisponible. Après une prise en compte possible de la commande, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN exige le rejeu de l’UUID/de la charge d’origine exacts ou la récupération du reçu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:documents:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 8388608
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/notifications/preferences

Lire les préférences personnelles de diffusion

`get_insight_notification_preferences`

OAuth personnel explicitement consenti, propriétaire courant uniquement, avec insight:read et le scope de cette opération. Les anciens grants, clés manuelles/root/système et données d’autrui sont refusés, même pour un ADMIN. Ne fournir ni acteur, organisation, destinataire, email, token d’appareil, preuve, sourcePolicy ni identité privée. Les champs inconnus sont refusés. GET passif : aucun calcul, acquisition, inscription d’appareil, rendu ou envoi. Les alertes ponctuelles sont désactivées par défaut. nightEnabled null signifie choix de silence quotidien inconnu, pas autorisation de livrer. Une configuration incomplète retient la diffusion concernée sans bloquer les analyses. Le lieu est une ville déclarée confirmée, jamais une preuve GPS. Les opt-ins email/avis hebdomadaires restent dans les préférences hebdomadaires distinctes.

### Authentification

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

### Permissions requises

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

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat personnel admis ou reçu immuable exact, sans identité de diffusion privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsPreferencesResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:notifications:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 1048576
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/notifications/preferences

Configurer les préférences personnelles de diffusion

`update_insight_notification_preferences`

OAuth personnel explicitement consenti, propriétaire courant uniquement, avec insight:read et le scope de cette opération. Les anciens grants, clés manuelles/root/système et données d’autrui sont refusés, même pour un ADMIN. Ne fournir ni acteur, organisation, destinataire, email, token d’appareil, preuve, sourcePolicy ni identité privée. Les champs inconnus sont refusés. GET passif : aucun calcul, acquisition, inscription d’appareil, rendu ou envoi. Fournir UUID operationKey, expectedRevision exacte et au moins un champ. Omission conservée ; quietHours et location sont des tuples complets ou null. Les heures identiques sont refusées. Fuseau IANA explicite ; aucun repli Paris ni ville déduite ou confirmation automatique. Le client humain confirme la ville ; une IA ne doit pas inventer cette confirmation. Aucune capture, inscription de token ni remise immédiate. Après incertitude, rejouer exactement la même intention/clé/révision ; le reçu se lit avec le même scope configure, sans read supplémentaire.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:notifications:configure",
  "additional": [
    "insight:read"
  ]
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_e507089f51f89fe39e78"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat personnel admis ou reçu immuable exact, sans identité de diffusion privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:notifications:configure",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 1048576
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/notifications/preferences/operations/{operationKey}

Récupérer le reçu exact des préférences de diffusion

`get_insight_notification_preferences_operation`

OAuth personnel explicitement consenti, propriétaire courant uniquement, avec insight:read et le scope de cette opération. Les anciens grants, clés manuelles/root/système et données d’autrui sont refusés, même pour un ADMIN. Ne fournir ni acteur, organisation, destinataire, email, token d’appareil, preuve, sourcePolicy ni identité privée. Les champs inconnus sont refusés. GET passif : aucun calcul, acquisition, inscription d’appareil, rendu ou envoi. Fournir la UUID originale ; notifications:configure est requis comme pour la commande. Le reçu prouve la sauvegarde de cette intention, jamais un envoi ni la configuration courante. Son absence ne prouve pas qu’une sauvegarde interrompue ne terminera pas.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:notifications:configure",
  "additional": [
    "insight:read"
  ]
}
```

### Paramètres

```json
{
  "name": "operationKey",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat personnel admis ou reçu immuable exact, sans identité de diffusion privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:notifications:configure",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 1048576
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/notifications/status

Lire l’état personnel des canaux et silences

`get_insight_notification_status`

OAuth personnel explicitement consenti, propriétaire courant uniquement, avec insight:read et le scope de cette opération. Les anciens grants, clés manuelles/root/système et données d’autrui sont refusés, même pour un ADMIN. Ne fournir ni acteur, organisation, destinataire, email, token d’appareil, preuve, sourcePolicy ni identité privée. Les champs inconnus sont refusés. GET passif : aucun calcul, acquisition, inscription d’appareil, rendu ou envoi. Trois familles distinctes : alerte ponctuelle, avis hebdomadaire et email hebdomadaire. enabled décrit la disponibilité technique, optedIn le choix métier. allowed n’est pas une preuve d’envoi ; deferred/unknown/refused/disabled restent distincts. Counts accepted indique une acceptation fournisseur, pas une remise ou lecture humaine ; awaiting_email n’est pas une acceptation SMTP et uncertain interdit un renvoi automatique. Aucun token, email brut, quota intercompte ou identité privée n’est exposé.

### Authentification

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

### Permissions requises

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

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat personnel admis ou reçu immuable exact, sans identité de diffusion privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsStatusResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:notifications:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 1048576
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/alerts

Lister les alertes personnelles déjà préparées

`list_insight_alerts`

OAuth personnel explicite avec insight:alerts:read, insight:analyses:read et insight:read ; propriétaire et toutes les sources de la vue couramment admis. Les grants antérieurs, ADMIN d’autrui et clés manuelles/root/système sont refusés. Ne fournir ni acteur, organisation, sources, preuve ni destinataire. GET passif : aucune capture, inférence, file, relance ou remise. Pagination vivante bornée à 20 ; conserver nextCursor sans modification. Les métadonnées ne réautorisent aucun ancien sujet. admission unavailable conserve uniquement des métadonnées et subjectCount null. deliveryStatus accepted signifie acceptation fournisseur, pas réception ou lecture ; uncertain ne justifie pas un renvoi automatique. Aucun total exhaustif ni instantané transactionnel.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:alerts:read",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Paramètres

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

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 1500
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Alerte personnelle réadmise ou indisponibilité explicite sans ancien contenu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsListResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:alerts:read",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/alerts/{alertId}

Lire une alerte personnelle actuellement réadmise

`get_insight_alert`

OAuth personnel explicite avec insight:alerts:read, insight:analyses:read et insight:read ; propriétaire et toutes les sources de la vue couramment admis. Les grants antérieurs, ADMIN d’autrui et clés manuelles/root/système sont refusés. Ne fournir ni acteur, organisation, sources, preuve ni destinataire. GET passif : aucune capture, inférence, file, relance ou remise. Sélectionner l’identifiant exact annoncé. unavailable retourne subjects vide, sans ancien texte/proposition. Chaque sujet prêt contient son petit registre evidence : les evidenceIds du sujet, du motif et du delta se résolvent dans ce registre d’alerte, sans faux resultId I2 ni lecture arbitraire de collection. Les faits sont datés ; une suggestion reste une proposition. L’événement avant le prochain bilan motive un réexamen, pas une préparation manquante. Une alerte deferred_new_deadline conserve le report actif ; elle ne remet pas sa carte dans Situation actuelle et n’annule aucune déclaration.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "insight:alerts:read",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Paramètres

```json
{
  "name": "alertId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Alerte personnelle réadmise ou indisponibilité explicite sans ancien contenu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:alerts:read",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## Schémas

```json
{
  "components": {
    "schemas": {
      "InsightContextResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightContext"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightContext": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "common": {
            "$ref": "#/components/schemas/InsightCommonContext"
          },
          "personal": {
            "$ref": "#/components/schemas/InsightPersonalContext"
          },
          "permissions": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "canEditCommon": {
                "type": "boolean"
              }
            },
            "required": [
              "canEditCommon"
            ]
          },
          "onboarding": {
            "$ref": "#/components/schemas/InsightOnboarding"
          }
        },
        "required": [
          "common",
          "personal",
          "permissions",
          "onboarding"
        ]
      },
      "InsightCommonContext": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "revision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "mission": {
            "type": "string",
            "maxLength": 8000
          },
          "context": {
            "type": "string",
            "maxLength": 16000
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "updatedBy": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "nullable": true
          }
        },
        "required": [
          "revision",
          "mission",
          "context",
          "updatedAt",
          "updatedBy"
        ]
      },
      "InsightPersonalContext": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "revision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "audience": {
            "type": "string",
            "maxLength": 8000
          },
          "primaryPriority": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1
              },
              "text": {
                "type": "string",
                "maxLength": 4000,
                "minLength": 1
              },
              "dueOn": {
                "type": "string",
                "format": "date",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "nullable": true
              }
            },
            "required": [
              "id",
              "text",
              "dueOn"
            ],
            "nullable": true
          },
          "secondaryPriorities": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 100,
                  "minLength": 1
                },
                "text": {
                  "type": "string",
                  "maxLength": 4000,
                  "minLength": 1
                },
                "dueOn": {
                  "type": "string",
                  "format": "date",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                  "nullable": true
                }
              },
              "required": [
                "id",
                "text",
                "dueOn"
              ]
            }
          },
          "population": {
            "type": "string",
            "enum": [
              "local",
              "global"
            ]
          },
          "constraints": {
            "type": "string",
            "maxLength": 16000
          },
          "enrichment": {
            "type": "string",
            "maxLength": 16000
          },
          "confirmation": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "commonRevision": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "personalRevision": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "confirmedAt": {
                "type": "string",
                "format": "date-time"
              },
              "minimum": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "mission": {
                    "type": "string",
                    "maxLength": 8000
                  },
                  "audience": {
                    "type": "string",
                    "maxLength": 8000
                  },
                  "primaryPriority": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "id": {
                        "type": "string",
                        "maxLength": 100,
                        "minLength": 1
                      },
                      "text": {
                        "type": "string",
                        "maxLength": 4000,
                        "minLength": 1
                      },
                      "dueOn": {
                        "type": "string",
                        "format": "date",
                        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                        "nullable": true
                      }
                    },
                    "required": [
                      "id",
                      "text",
                      "dueOn"
                    ]
                  },
                  "population": {
                    "type": "string",
                    "enum": [
                      "local",
                      "global"
                    ]
                  }
                },
                "required": [
                  "mission",
                  "audience",
                  "primaryPriority",
                  "population"
                ]
              }
            },
            "required": [
              "commonRevision",
              "personalRevision",
              "confirmedAt",
              "minimum"
            ],
            "nullable": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "required": [
          "revision",
          "audience",
          "primaryPriority",
          "secondaryPriorities",
          "population",
          "constraints",
          "enrichment",
          "confirmation",
          "updatedAt"
        ]
      },
      "InsightOnboarding": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "minimum": {
            "type": "string",
            "enum": [
              "not_started",
              "draft",
              "confirmed"
            ]
          },
          "missing": {
            "type": "array",
            "maxItems": 3,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "mission",
                "audience",
                "primaryPriority"
              ]
            }
          },
          "optional": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "constraints": {
                "type": "boolean"
              },
              "enrichment": {
                "type": "boolean"
              }
            },
            "required": [
              "constraints",
              "enrichment"
            ]
          },
          "commonChangedSinceConfirmation": {
            "type": "boolean"
          },
          "activation": {
            "type": "string",
            "enum": [
              "awaiting_initial_report"
            ]
          }
        },
        "required": [
          "minimum",
          "missing",
          "optional",
          "commonChangedSinceConfirmation",
          "activation"
        ]
      },
      "InsightError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "InsightReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "saveCommon",
              "savePersonal",
              "confirmOnboarding"
            ]
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "appliedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "appliedAt": {
            "type": "string",
            "format": "date-time"
          },
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          }
        },
        "required": [
          "action",
          "expectedRevision",
          "appliedRevision",
          "appliedAt",
          "operationKey"
        ]
      },
      "UnisoftRequest_86acc4db603dce0726a0": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "audience": {
            "type": "string",
            "maxLength": 8000
          },
          "primaryPriority": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              },
              "text": {
                "type": "string",
                "minLength": 1,
                "maxLength": 4000
              },
              "dueOn": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "format": "date",
                "nullable": true
              }
            },
            "required": [
              "id",
              "text",
              "dueOn"
            ],
            "additionalProperties": false,
            "nullable": true
          },
          "secondaryPriorities": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                },
                "text": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 4000
                },
                "dueOn": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                  "format": "date",
                  "nullable": true
                }
              },
              "required": [
                "id",
                "text",
                "dueOn"
              ],
              "additionalProperties": false
            }
          },
          "population": {
            "type": "string",
            "enum": [
              "local",
              "global"
            ]
          },
          "constraints": {
            "type": "string",
            "maxLength": 16000
          },
          "enrichment": {
            "type": "string",
            "maxLength": 16000
          }
        },
        "required": [
          "operationKey",
          "expectedRevision"
        ],
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "audience"
            ]
          },
          {
            "required": [
              "primaryPriority"
            ]
          },
          {
            "required": [
              "secondaryPriorities"
            ]
          },
          {
            "required": [
              "population"
            ]
          },
          {
            "required": [
              "constraints"
            ]
          },
          {
            "required": [
              "enrichment"
            ]
          }
        ]
      },
      "InsightOnboardingResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightOnboarding"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAnalysisReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAnalysisReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAnalysisReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          },
          "acceptedAt": {
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "type": "string",
            "enum": [
              "queued"
            ]
          },
          "language": {
            "type": "string",
            "enum": [
              "fr",
              "en",
              "he",
              "de",
              "es",
              "gr",
              "ro"
            ],
            "description": "Langue de l’API : fr français, en anglais, he hébreu, de allemand, es espagnol, gr grec, ro roumain. Si la langue est omise, la valeur par défaut est fr."
          },
          "frameRevision": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "common": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "personal": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "common",
              "personal"
            ]
          }
        },
        "required": [
          "id",
          "operationKey",
          "acceptedAt",
          "status",
          "language",
          "frameRevision"
        ]
      },
      "InsightAnalysisError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "InsightAnalysisStateResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAnalysisState"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAnalysisState": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "missing",
              "pending",
              "queued",
              "running",
              "ready",
              "failed",
              "stale"
            ]
          },
          "id": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "nullable": true
          },
          "receipt": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "operationKey": {
                "type": "string",
                "format": "uuid",
                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
              },
              "acceptedAt": {
                "type": "string",
                "format": "date-time"
              },
              "status": {
                "type": "string",
                "enum": [
                  "queued"
                ]
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ],
                "description": "Langue de l’API : fr français, en anglais, he hébreu, de allemand, es espagnol, gr grec, ro roumain. Si la langue est omise, la valeur par défaut est fr."
              },
              "frameRevision": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "common": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "personal": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "common",
                  "personal"
                ]
              }
            },
            "required": [
              "id",
              "operationKey",
              "acceptedAt",
              "status",
              "language",
              "frameRevision"
            ],
            "nullable": true
          },
          "result": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "version": {
                "type": "integer",
                "enum": [
                  1
                ]
              },
              "status": {
                "type": "string",
                "enum": [
                  "ready"
                ]
              },
              "generatedAt": {
                "type": "string",
                "format": "date-time"
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ],
                "description": "Langue de l’API : fr français, en anglais, he hébreu, de allemand, es espagnol, gr grec, ro roumain. Si la langue est omise, la valeur par défaut est fr."
              },
              "frameRevision": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "common": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "personal": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "common",
                  "personal"
                ]
              },
              "summary": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2400
                  },
                  "evidenceIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "maxItems": 100,
                    "uniqueItems": true
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "facts_only",
                      "admitted_topics"
                    ]
                  }
                },
                "required": [
                  "text",
                  "evidenceIds"
                ]
              },
              "topics": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 250
                    },
                    "family": {
                      "type": "string",
                      "enum": [
                        "documented_attention",
                        "event_opportunity",
                        "priority_review",
                        "recorded_relationship",
                        "recorded_resources",
                        "calendar_preparation",
                        "relationship_continuity",
                        "activity_history"
                      ]
                    },
                    "title": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "conclusion": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "reason": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "proposal": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "text": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1200
                        },
                        "kind": {
                          "type": "string",
                          "enum": [
                            "human_review"
                          ]
                        },
                        "targetId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "text",
                        "kind",
                        "targetId"
                      ]
                    },
                    "evidenceIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "maxItems": 100,
                      "uniqueItems": true
                    },
                    "priorityIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "maxItems": 100,
                      "uniqueItems": true
                    },
                    "caveats": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    },
                    "reviewAction": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "type": {
                          "type": "string",
                          "enum": [
                            "review_documented_need",
                            "review_event_fit",
                            "reassess_priority",
                            "review_recorded_exchange",
                            "review_recorded_resources",
                            "review_calendar_preparation",
                            "review_relationship_continuity",
                            "review_activity_history"
                          ]
                        },
                        "targetId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "id",
                        "type",
                        "targetId"
                      ]
                    },
                    "reappearance": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "text": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 800
                        },
                        "evidenceIds": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "maxItems": 100,
                          "uniqueItems": true
                        }
                      },
                      "required": [
                        "text",
                        "evidenceIds"
                      ],
                      "nullable": true
                    }
                  },
                  "required": [
                    "id",
                    "family",
                    "title",
                    "conclusion",
                    "reason",
                    "proposal",
                    "evidenceIds",
                    "priorityIds",
                    "caveats"
                  ]
                },
                "maxItems": 5
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "nature": {
                      "type": "string",
                      "enum": [
                        "declared",
                        "recorded_fact",
                        "prepared_suggestion"
                      ]
                    },
                    "source": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "collection": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "collection",
                        "id"
                      ],
                      "nullable": true
                    },
                    "contactId": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "nullable": true
                    },
                    "observedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "occurredAt": {
                      "type": "string",
                      "format": "date-time",
                      "nullable": true
                    },
                    "occurredOn": {
                      "type": "string",
                      "format": "date",
                      "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                      "nullable": true
                    },
                    "datePrecision": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "labelCode": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "text": {
                      "type": "string",
                      "minLength": 0,
                      "maxLength": 16000
                    },
                    "facts": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "code": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$",
                            "description": "Fait typé admis. contact_marked_local est true/false/null pour le marquage local actuel, pas une localisation physique. registration_count compte les contacts inscrits admis, pas des familles ni des présences. La couverture ne mesure pas l’avancement des préparatifs. Faits des sources étendues DEV : recorded_interaction est une trace CRM datée, pas un besoin non satisfait prouvé. recorded_resources sépare les devises et deux périodes UTC complètes de 30 jours excluant la journée courante ; l’unité monétaire minor:CODE:EXP signifie diviser par 10^EXP. Des totaux null indiquent des données non qualifiées ou exclues, jamais zéro. Ce sont des paiements bruts enregistrés, pas une trésorerie disponible, uniquement des dons, un règlement bancaire ou un budget de projet. community_calendar est une échéance civile calculée, pas une disponibilité personnelle ni un préparatif manquant. Les vues DEV relationship_history et activity_history exigent conjointement contacts, events et registrations. firstVisibleRegistrationAt désigne la première inscription validée visible dans la fenêtre de 180 jours, pas le début réel de la relation. laterRecordedInteractionCount compte les traces instantanées strictement ultérieures ; une précision au jour ne prouve pas l’ordre. Les activités sont réparties par début enregistré de l’événement, pas par création d’inscription, sur deux périodes UTC complètes de 90 jours. Contacts distincts, couples contact–événement et moyennes par événement sont des unités différentes. comparisonAvailable=false interdit une comparaison de tendance. Les identifiants sources synthétiques insight_relationship_history et insight_activity_history sont des projections opaques, pas des identifiants d’événement. Un même groupe explicite ne prouve pas des formats/publics identiques, une présence, fidélité ou efficacité causale. Les inscriptions valides archivées sont incluses dans leur état actuel ; aucune photographie historique immuable n’est implicite. Les bornes from/splitAt/to sont des bornes UTC semi-ouvertes ; la fin est exclue. La continuité sans inscription est aussi admise : firstVisibleInteractionAt/lastVisibleInteractionAt et laterRecordedExchangeCount se réfèrent au premier échange instantané visible. laterRecordedInteractionCount reste relatif à la première inscription visible et vaut null sans celle-ci. firstEverContactAt/firstEverRegistrationAt restent inconnus. registrationChronologyKnown=false masque les mesures d’inscription sans inventer zéro ni supprimer les échanges datés qualifiés."
                          },
                          "value": {
                            "oneOf": [
                              {
                                "type": "string",
                                "maxLength": 16000
                              },
                              {
                                "type": "number"
                              },
                              {
                                "type": "boolean"
                              },
                              {
                                "type": "string",
                                "nullable": true,
                                "enum": [
                                  null
                                ]
                              }
                            ]
                          },
                          "unit": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100,
                            "nullable": true
                          }
                        },
                        "required": [
                          "code",
                          "value",
                          "unit"
                        ]
                      },
                      "maxItems": 100
                    },
                    "references": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "collection": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "id": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "contactId": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "nullable": true
                          },
                          "quote": {
                            "type": "string",
                            "minLength": 0,
                            "maxLength": 10000,
                            "nullable": true
                          },
                          "at": {
                            "type": "string",
                            "format": "date-time",
                            "nullable": true
                          },
                          "occurredOn": {
                            "type": "string",
                            "format": "date",
                            "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                            "nullable": true
                          },
                          "datePrecision": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          }
                        },
                        "required": [
                          "collection",
                          "id",
                          "contactId",
                          "quote",
                          "at",
                          "occurredOn",
                          "datePrecision"
                        ]
                      },
                      "maxItems": 100
                    },
                    "limits": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    }
                  },
                  "required": [
                    "id",
                    "nature",
                    "source",
                    "contactId",
                    "observedAt",
                    "occurredAt",
                    "occurredOn",
                    "datePrecision",
                    "labelCode",
                    "text",
                    "facts",
                    "references",
                    "limits"
                  ]
                },
                "maxItems": 120
              },
              "clarifications": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "text": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 500
                    }
                  },
                  "required": [
                    "text"
                  ]
                },
                "maxItems": 1
              },
              "coverage": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "complete",
                      "partial",
                      "unknown"
                    ]
                  },
                  "sources": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "family": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200,
                          "pattern": "^[A-Za-z0-9_:.\\-]+$"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "available",
                            "partial",
                            "unavailable",
                            "forbidden",
                            "unknown"
                          ]
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "nullable": true
                        },
                        "limits": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          },
                          "maxItems": 100
                        }
                      },
                      "required": [
                        "family",
                        "status",
                        "count",
                        "limits"
                      ]
                    },
                    "maxItems": 30
                  },
                  "limits": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "maxItems": 100
                  },
                  "localDate": {
                    "type": "string",
                    "format": "date",
                    "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                    "nullable": true
                  },
                  "calendarReview": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$"
                  }
                },
                "required": [
                  "status",
                  "sources",
                  "limits",
                  "localDate",
                  "calendarReview"
                ]
              },
              "privacy": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "classification": {
                    "type": "string",
                    "enum": [
                      "personal"
                    ]
                  },
                  "privateDependencies": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "personal_frame",
                        "constraints",
                        "enrichment"
                      ]
                    },
                    "maxItems": 3,
                    "uniqueItems": true
                  }
                },
                "required": [
                  "classification",
                  "privateDependencies"
                ]
              }
            },
            "required": [
              "version",
              "status",
              "generatedAt",
              "language",
              "frameRevision",
              "summary",
              "topics",
              "evidence",
              "clarifications",
              "coverage",
              "privacy"
            ],
            "nullable": true
          },
          "error": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "INSIGHT_ANALYSIS_FAILED"
                ]
              }
            },
            "required": [
              "code"
            ],
            "nullable": true
          },
          "waitReason": {
            "type": "string",
            "enum": [
              "structured_inference_budget"
            ]
          },
          "retryAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "status",
          "id",
          "receipt",
          "result",
          "error"
        ]
      },
      "InsightAnalysisTopicsResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAnalysisTopics"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAnalysisTopics": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "missing",
              "pending",
              "queued",
              "running",
              "ready",
              "failed",
              "stale"
            ]
          },
          "id": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "nullable": true
          },
          "receipt": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "operationKey": {
                "type": "string",
                "format": "uuid",
                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
              },
              "acceptedAt": {
                "type": "string",
                "format": "date-time"
              },
              "status": {
                "type": "string",
                "enum": [
                  "queued"
                ]
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ],
                "description": "Langue de l’API : fr français, en anglais, he hébreu, de allemand, es espagnol, gr grec, ro roumain. Si la langue est omise, la valeur par défaut est fr."
              },
              "frameRevision": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "common": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "personal": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "common",
                  "personal"
                ]
              }
            },
            "required": [
              "id",
              "operationKey",
              "acceptedAt",
              "status",
              "language",
              "frameRevision"
            ],
            "nullable": true
          },
          "error": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "INSIGHT_ANALYSIS_FAILED"
                ]
              }
            },
            "required": [
              "code"
            ],
            "nullable": true
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 250
                },
                "family": {
                  "type": "string",
                  "enum": [
                    "documented_attention",
                    "event_opportunity",
                    "priority_review",
                    "recorded_relationship",
                    "recorded_resources",
                    "calendar_preparation",
                    "relationship_continuity",
                    "activity_history"
                  ]
                },
                "title": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "conclusion": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 1200
                },
                "reason": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 1200
                },
                "proposal": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "text": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "kind": {
                      "type": "string",
                      "enum": [
                        "human_review"
                      ]
                    },
                    "targetId": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    }
                  },
                  "required": [
                    "text",
                    "kind",
                    "targetId"
                  ]
                },
                "evidenceIds": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "maxItems": 100,
                  "uniqueItems": true
                },
                "priorityIds": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "maxItems": 100,
                  "uniqueItems": true
                },
                "caveats": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$"
                  },
                  "maxItems": 100
                },
                "reviewAction": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "review_documented_need",
                        "review_event_fit",
                        "reassess_priority",
                        "review_recorded_exchange",
                        "review_recorded_resources",
                        "review_calendar_preparation",
                        "review_relationship_continuity",
                        "review_activity_history"
                      ]
                    },
                    "targetId": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    }
                  },
                  "required": [
                    "id",
                    "type",
                    "targetId"
                  ]
                },
                "reappearance": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "text": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 800
                    },
                    "evidenceIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "maxItems": 100,
                      "uniqueItems": true
                    }
                  },
                  "required": [
                    "text",
                    "evidenceIds"
                  ],
                  "nullable": true
                }
              },
              "required": [
                "id",
                "family",
                "title",
                "conclusion",
                "reason",
                "proposal",
                "evidenceIds",
                "priorityIds",
                "caveats"
              ]
            },
            "maxItems": 5
          },
          "coverage": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "complete",
                  "partial",
                  "unknown"
                ]
              },
              "sources": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "family": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "available",
                        "partial",
                        "unavailable",
                        "forbidden",
                        "unknown"
                      ]
                    },
                    "count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "nullable": true
                    },
                    "limits": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    }
                  },
                  "required": [
                    "family",
                    "status",
                    "count",
                    "limits"
                  ]
                },
                "maxItems": 30
              },
              "limits": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "maxItems": 100
              },
              "localDate": {
                "type": "string",
                "format": "date",
                "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                "nullable": true
              },
              "calendarReview": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9_:.\\-]+$"
              }
            },
            "required": [
              "status",
              "sources",
              "limits",
              "localDate",
              "calendarReview"
            ],
            "nullable": true
          },
          "waitReason": {
            "type": "string",
            "enum": [
              "structured_inference_budget"
            ]
          },
          "retryAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "status",
          "id",
          "receipt",
          "error",
          "items",
          "coverage"
        ]
      },
      "InsightAnalysisTopicStateResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAnalysisTopicState"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAnalysisTopicState": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "missing",
              "pending",
              "queued",
              "running",
              "ready",
              "failed",
              "stale"
            ]
          },
          "id": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "nullable": true
          },
          "receipt": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "operationKey": {
                "type": "string",
                "format": "uuid",
                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
              },
              "acceptedAt": {
                "type": "string",
                "format": "date-time"
              },
              "status": {
                "type": "string",
                "enum": [
                  "queued"
                ]
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ],
                "description": "Langue de l’API : fr français, en anglais, he hébreu, de allemand, es espagnol, gr grec, ro roumain. Si la langue est omise, la valeur par défaut est fr."
              },
              "frameRevision": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "common": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "personal": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "common",
                  "personal"
                ]
              }
            },
            "required": [
              "id",
              "operationKey",
              "acceptedAt",
              "status",
              "language",
              "frameRevision"
            ],
            "nullable": true
          },
          "error": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "INSIGHT_ANALYSIS_FAILED"
                ]
              }
            },
            "required": [
              "code"
            ],
            "nullable": true
          },
          "topic": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 250
              },
              "family": {
                "type": "string",
                "enum": [
                  "documented_attention",
                  "event_opportunity",
                  "priority_review",
                  "recorded_relationship",
                  "recorded_resources",
                  "calendar_preparation",
                  "relationship_continuity",
                  "activity_history"
                ]
              },
              "title": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              },
              "conclusion": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1200
              },
              "reason": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1200
              },
              "proposal": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1200
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "human_review"
                    ]
                  },
                  "targetId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  }
                },
                "required": [
                  "text",
                  "kind",
                  "targetId"
                ]
              },
              "evidenceIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "maxItems": 100,
                "uniqueItems": true
              },
              "priorityIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                },
                "maxItems": 100,
                "uniqueItems": true
              },
              "caveats": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "maxItems": 100
              },
              "reviewAction": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "review_documented_need",
                      "review_event_fit",
                      "reassess_priority",
                      "review_recorded_exchange",
                      "review_recorded_resources",
                      "review_calendar_preparation",
                      "review_relationship_continuity",
                      "review_activity_history"
                    ]
                  },
                  "targetId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  }
                },
                "required": [
                  "id",
                  "type",
                  "targetId"
                ]
              },
              "reappearance": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 800
                  },
                  "evidenceIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "maxItems": 100,
                    "uniqueItems": true
                  }
                },
                "required": [
                  "text",
                  "evidenceIds"
                ],
                "nullable": true
              }
            },
            "required": [
              "id",
              "family",
              "title",
              "conclusion",
              "reason",
              "proposal",
              "evidenceIds",
              "priorityIds",
              "caveats"
            ],
            "nullable": true
          },
          "coverage": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "complete",
                  "partial",
                  "unknown"
                ]
              },
              "sources": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "family": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "available",
                        "partial",
                        "unavailable",
                        "forbidden",
                        "unknown"
                      ]
                    },
                    "count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "nullable": true
                    },
                    "limits": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    }
                  },
                  "required": [
                    "family",
                    "status",
                    "count",
                    "limits"
                  ]
                },
                "maxItems": 30
              },
              "limits": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "maxItems": 100
              },
              "localDate": {
                "type": "string",
                "format": "date",
                "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                "nullable": true
              },
              "calendarReview": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9_:.\\-]+$"
              }
            },
            "required": [
              "status",
              "sources",
              "limits",
              "localDate",
              "calendarReview"
            ],
            "nullable": true
          },
          "waitReason": {
            "type": "string",
            "enum": [
              "structured_inference_budget"
            ]
          },
          "retryAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "status",
          "id",
          "receipt",
          "error",
          "topic",
          "coverage"
        ]
      },
      "InsightAnalysisEvidenceResultResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAnalysisEvidenceResult"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAnalysisEvidenceResult": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "evidence": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              },
              "nature": {
                "type": "string",
                "enum": [
                  "declared",
                  "recorded_fact",
                  "prepared_suggestion"
                ]
              },
              "source": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "collection": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  }
                },
                "required": [
                  "collection",
                  "id"
                ],
                "nullable": true
              },
              "contactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "nullable": true
              },
              "observedAt": {
                "type": "string",
                "format": "date-time"
              },
              "occurredAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true
              },
              "occurredOn": {
                "type": "string",
                "format": "date",
                "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                "nullable": true
              },
              "datePrecision": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9_:.\\-]+$"
              },
              "labelCode": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9_:.\\-]+$"
              },
              "text": {
                "type": "string",
                "minLength": 0,
                "maxLength": 16000
              },
              "facts": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "code": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$",
                      "description": "Fait typé admis. contact_marked_local est true/false/null pour le marquage local actuel, pas une localisation physique. registration_count compte les contacts inscrits admis, pas des familles ni des présences. La couverture ne mesure pas l’avancement des préparatifs. Faits des sources étendues DEV : recorded_interaction est une trace CRM datée, pas un besoin non satisfait prouvé. recorded_resources sépare les devises et deux périodes UTC complètes de 30 jours excluant la journée courante ; l’unité monétaire minor:CODE:EXP signifie diviser par 10^EXP. Des totaux null indiquent des données non qualifiées ou exclues, jamais zéro. Ce sont des paiements bruts enregistrés, pas une trésorerie disponible, uniquement des dons, un règlement bancaire ou un budget de projet. community_calendar est une échéance civile calculée, pas une disponibilité personnelle ni un préparatif manquant. Les vues DEV relationship_history et activity_history exigent conjointement contacts, events et registrations. firstVisibleRegistrationAt désigne la première inscription validée visible dans la fenêtre de 180 jours, pas le début réel de la relation. laterRecordedInteractionCount compte les traces instantanées strictement ultérieures ; une précision au jour ne prouve pas l’ordre. Les activités sont réparties par début enregistré de l’événement, pas par création d’inscription, sur deux périodes UTC complètes de 90 jours. Contacts distincts, couples contact–événement et moyennes par événement sont des unités différentes. comparisonAvailable=false interdit une comparaison de tendance. Les identifiants sources synthétiques insight_relationship_history et insight_activity_history sont des projections opaques, pas des identifiants d’événement. Un même groupe explicite ne prouve pas des formats/publics identiques, une présence, fidélité ou efficacité causale. Les inscriptions valides archivées sont incluses dans leur état actuel ; aucune photographie historique immuable n’est implicite. Les bornes from/splitAt/to sont des bornes UTC semi-ouvertes ; la fin est exclue. La continuité sans inscription est aussi admise : firstVisibleInteractionAt/lastVisibleInteractionAt et laterRecordedExchangeCount se réfèrent au premier échange instantané visible. laterRecordedInteractionCount reste relatif à la première inscription visible et vaut null sans celle-ci. firstEverContactAt/firstEverRegistrationAt restent inconnus. registrationChronologyKnown=false masque les mesures d’inscription sans inventer zéro ni supprimer les échanges datés qualifiés."
                    },
                    "value": {
                      "oneOf": [
                        {
                          "type": "string",
                          "maxLength": 16000
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "string",
                          "nullable": true,
                          "enum": [
                            null
                          ]
                        }
                      ]
                    },
                    "unit": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100,
                      "nullable": true
                    }
                  },
                  "required": [
                    "code",
                    "value",
                    "unit"
                  ]
                },
                "maxItems": 100
              },
              "references": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "collection": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    },
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "contactId": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "nullable": true
                    },
                    "quote": {
                      "type": "string",
                      "minLength": 0,
                      "maxLength": 10000,
                      "nullable": true
                    },
                    "at": {
                      "type": "string",
                      "format": "date-time",
                      "nullable": true
                    },
                    "occurredOn": {
                      "type": "string",
                      "format": "date",
                      "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                      "nullable": true
                    },
                    "datePrecision": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    }
                  },
                  "required": [
                    "collection",
                    "id",
                    "contactId",
                    "quote",
                    "at",
                    "occurredOn",
                    "datePrecision"
                  ]
                },
                "maxItems": 100
              },
              "limits": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "maxItems": 100
              }
            },
            "required": [
              "id",
              "nature",
              "source",
              "contactId",
              "observedAt",
              "occurredAt",
              "occurredOn",
              "datePrecision",
              "labelCode",
              "text",
              "facts",
              "references",
              "limits"
            ]
          }
        },
        "required": [
          "id",
          "evidence"
        ]
      },
      "InsightAnalysisPreparationResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAnalysisPreparation"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAnalysisPreparation": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "facts_only"
            ]
          },
          "preparedAt": {
            "type": "string",
            "format": "date-time"
          },
          "frameRevision": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "common": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "personal": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "common",
              "personal"
            ]
          },
          "population": {
            "type": "string",
            "enum": [
              "local",
              "global"
            ]
          },
          "observations": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "nature": {
                  "type": "string",
                  "enum": [
                    "declared",
                    "recorded_fact",
                    "prepared_suggestion"
                  ]
                },
                "source": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "collection": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    },
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    }
                  },
                  "required": [
                    "collection",
                    "id"
                  ],
                  "nullable": true
                },
                "contactId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "nullable": true
                },
                "observedAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "occurredAt": {
                  "type": "string",
                  "format": "date-time",
                  "nullable": true
                },
                "occurredOn": {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                  "nullable": true
                },
                "datePrecision": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "labelCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "text": {
                  "type": "string",
                  "minLength": 0,
                  "maxLength": 16000
                },
                "facts": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "code": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$",
                        "description": "Fait typé admis. contact_marked_local est true/false/null pour le marquage local actuel, pas une localisation physique. registration_count compte les contacts inscrits admis, pas des familles ni des présences. La couverture ne mesure pas l’avancement des préparatifs. Faits des sources étendues DEV : recorded_interaction est une trace CRM datée, pas un besoin non satisfait prouvé. recorded_resources sépare les devises et deux périodes UTC complètes de 30 jours excluant la journée courante ; l’unité monétaire minor:CODE:EXP signifie diviser par 10^EXP. Des totaux null indiquent des données non qualifiées ou exclues, jamais zéro. Ce sont des paiements bruts enregistrés, pas une trésorerie disponible, uniquement des dons, un règlement bancaire ou un budget de projet. community_calendar est une échéance civile calculée, pas une disponibilité personnelle ni un préparatif manquant. Les vues DEV relationship_history et activity_history exigent conjointement contacts, events et registrations. firstVisibleRegistrationAt désigne la première inscription validée visible dans la fenêtre de 180 jours, pas le début réel de la relation. laterRecordedInteractionCount compte les traces instantanées strictement ultérieures ; une précision au jour ne prouve pas l’ordre. Les activités sont réparties par début enregistré de l’événement, pas par création d’inscription, sur deux périodes UTC complètes de 90 jours. Contacts distincts, couples contact–événement et moyennes par événement sont des unités différentes. comparisonAvailable=false interdit une comparaison de tendance. Les identifiants sources synthétiques insight_relationship_history et insight_activity_history sont des projections opaques, pas des identifiants d’événement. Un même groupe explicite ne prouve pas des formats/publics identiques, une présence, fidélité ou efficacité causale. Les inscriptions valides archivées sont incluses dans leur état actuel ; aucune photographie historique immuable n’est implicite. Les bornes from/splitAt/to sont des bornes UTC semi-ouvertes ; la fin est exclue. La continuité sans inscription est aussi admise : firstVisibleInteractionAt/lastVisibleInteractionAt et laterRecordedExchangeCount se réfèrent au premier échange instantané visible. laterRecordedInteractionCount reste relatif à la première inscription visible et vaut null sans celle-ci. firstEverContactAt/firstEverRegistrationAt restent inconnus. registrationChronologyKnown=false masque les mesures d’inscription sans inventer zéro ni supprimer les échanges datés qualifiés."
                      },
                      "value": {
                        "oneOf": [
                          {
                            "type": "string",
                            "maxLength": 16000
                          },
                          {
                            "type": "number"
                          },
                          {
                            "type": "boolean"
                          },
                          {
                            "type": "string",
                            "nullable": true,
                            "enum": [
                              null
                            ]
                          }
                        ]
                      },
                      "unit": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100,
                        "nullable": true
                      }
                    },
                    "required": [
                      "code",
                      "value",
                      "unit"
                    ]
                  },
                  "maxItems": 100
                },
                "references": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "collection": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "contactId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "nullable": true
                      },
                      "quote": {
                        "type": "string",
                        "minLength": 0,
                        "maxLength": 10000,
                        "nullable": true
                      },
                      "at": {
                        "type": "string",
                        "format": "date-time",
                        "nullable": true
                      },
                      "occurredOn": {
                        "type": "string",
                        "format": "date",
                        "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                        "nullable": true
                      },
                      "datePrecision": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      }
                    },
                    "required": [
                      "collection",
                      "id",
                      "contactId",
                      "quote",
                      "at",
                      "occurredOn",
                      "datePrecision"
                    ]
                  },
                  "maxItems": 100
                },
                "limits": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$"
                  },
                  "maxItems": 100
                }
              },
              "required": [
                "id",
                "nature",
                "source",
                "contactId",
                "observedAt",
                "occurredAt",
                "occurredOn",
                "datePrecision",
                "labelCode",
                "text",
                "facts",
                "references",
                "limits"
              ]
            },
            "maxItems": 6
          },
          "coverage": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "complete",
                  "partial",
                  "unknown"
                ]
              },
              "sources": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "family": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "available",
                        "partial",
                        "unavailable",
                        "forbidden",
                        "unknown"
                      ]
                    },
                    "count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "nullable": true
                    },
                    "limits": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    }
                  },
                  "required": [
                    "family",
                    "status",
                    "count",
                    "limits"
                  ]
                },
                "maxItems": 30
              },
              "limits": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "maxItems": 100
              },
              "localDate": {
                "type": "string",
                "format": "date",
                "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                "nullable": true
              },
              "calendarReview": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9_:.\\-]+$"
              }
            },
            "required": [
              "status",
              "sources",
              "limits",
              "localDate",
              "calendarReview"
            ]
          },
          "privacy": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "classification": {
                "type": "string",
                "enum": [
                  "personal"
                ]
              },
              "privateDependencies": {
                "type": "array",
                "maxItems": 0,
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                }
              }
            },
            "required": [
              "classification",
              "privateDependencies"
            ]
          }
        },
        "required": [
          "status",
          "preparedAt",
          "frameRevision",
          "population",
          "observations",
          "coverage",
          "privacy"
        ]
      },
      "InsightFeedbackStateResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightFeedbackState"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightFeedbackState": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "actionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "revision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740990
          },
          "declarations": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "declarationId": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                },
                "actionId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 250
                },
                "actionType": {
                  "type": "string",
                  "enum": [
                    "review_documented_need",
                    "review_event_fit",
                    "reassess_priority",
                    "review_recorded_exchange",
                    "review_recorded_resources",
                    "review_calendar_preparation",
                    "review_relationship_continuity",
                    "review_activity_history"
                  ]
                },
                "kind": {
                  "type": "string",
                  "enum": [
                    "done",
                    "not_relevant",
                    "defer"
                  ]
                },
                "active": {
                  "type": "boolean"
                },
                "declaredAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "undoneAt": {
                  "type": "string",
                  "format": "date-time",
                  "nullable": true
                },
                "dueOn": {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                  "nullable": true
                },
                "timeZone": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100,
                  "nullable": true
                },
                "untilAt": {
                  "type": "string",
                  "format": "date-time",
                  "nullable": true
                },
                "comment": {
                  "type": "string",
                  "minLength": 0,
                  "maxLength": 2000,
                  "nullable": true
                },
                "subject": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "contact",
                        "event",
                        "priority",
                        "resources",
                        "calendar",
                        "activities"
                      ]
                    },
                    "label": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 4000,
                      "pattern": "\\S"
                    }
                  },
                  "required": [
                    "kind",
                    "label"
                  ],
                  "nullable": true
                },
                "contentState": {
                  "type": "string",
                  "enum": [
                    "readmitted",
                    "redacted"
                  ]
                }
              },
              "required": [
                "declarationId",
                "actionId",
                "actionType",
                "kind",
                "active",
                "declaredAt",
                "undoneAt",
                "dueOn",
                "timeZone",
                "untilAt",
                "comment",
                "subject",
                "contentState"
              ]
            },
            "maxItems": 200
          }
        },
        "required": [
          "actionId",
          "revision",
          "declarations"
        ]
      },
      "InsightFeedbackError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "InsightFeedbackHistoryResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightFeedbackHistory"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightFeedbackHistory": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "actionId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 250
                },
                "revision": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740990
                },
                "declarations": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "declarationId": {
                        "type": "string",
                        "pattern": "^[a-f0-9]{64}$"
                      },
                      "actionId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 250
                      },
                      "actionType": {
                        "type": "string",
                        "enum": [
                          "review_documented_need",
                          "review_event_fit",
                          "reassess_priority",
                          "review_recorded_exchange",
                          "review_recorded_resources",
                          "review_calendar_preparation",
                          "review_relationship_continuity",
                          "review_activity_history"
                        ]
                      },
                      "kind": {
                        "type": "string",
                        "enum": [
                          "done",
                          "not_relevant",
                          "defer"
                        ]
                      },
                      "active": {
                        "type": "boolean"
                      },
                      "declaredAt": {
                        "type": "string",
                        "format": "date-time"
                      },
                      "undoneAt": {
                        "type": "string",
                        "format": "date-time",
                        "nullable": true
                      },
                      "dueOn": {
                        "type": "string",
                        "format": "date",
                        "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                        "nullable": true
                      },
                      "timeZone": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100,
                        "nullable": true
                      },
                      "untilAt": {
                        "type": "string",
                        "format": "date-time",
                        "nullable": true
                      },
                      "comment": {
                        "type": "string",
                        "minLength": 0,
                        "maxLength": 2000,
                        "nullable": true
                      },
                      "subject": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "kind": {
                            "type": "string",
                            "enum": [
                              "contact",
                              "event",
                              "priority",
                              "resources",
                              "calendar",
                              "activities"
                            ]
                          },
                          "label": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 4000,
                            "pattern": "\\S"
                          }
                        },
                        "required": [
                          "kind",
                          "label"
                        ],
                        "nullable": true
                      },
                      "contentState": {
                        "type": "string",
                        "enum": [
                          "readmitted",
                          "redacted"
                        ]
                      }
                    },
                    "required": [
                      "declarationId",
                      "actionId",
                      "actionType",
                      "kind",
                      "active",
                      "declaredAt",
                      "undoneAt",
                      "dueOn",
                      "timeZone",
                      "untilAt",
                      "comment",
                      "subject",
                      "contentState"
                    ]
                  },
                  "maxItems": 200
                }
              },
              "required": [
                "actionId",
                "revision",
                "declarations"
              ]
            },
            "maxItems": 50
          },
          "hasMore": {
            "type": "boolean"
          },
          "nextCursor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000,
            "nullable": true
          }
        },
        "required": [
          "items",
          "hasMore",
          "nextCursor"
        ]
      },
      "InsightFeedbackReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightFeedbackReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightFeedbackReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "declare",
              "undo"
            ]
          },
          "actionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "declarationId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "appliedRevision": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "appliedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "action",
          "actionId",
          "declarationId",
          "operationKey",
          "expectedRevision",
          "appliedRevision",
          "appliedAt"
        ]
      },
      "UnisoftRequest_c7980fb3ed49b957c11a": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "resultId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "topicId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "actionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "dueOn": {
            "type": "string",
            "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
            "format": "date"
          },
          "timeZone": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "Fuseau horaire IANA valide explicite. Le réexamen commence au premier instant existant de dueOn dans ce fuseau, et non à la fin de la journée. Pour une nouvelle déclaration, cet instant doit se situer strictement dans le futur, y compris au moment de l’admission finale précédant l’écriture. La récupération d’un reçu exact existant reste possible après expiration."
          }
        },
        "required": [
          "operationKey",
          "expectedRevision",
          "resultId",
          "topicId",
          "actionId",
          "dueOn",
          "timeZone"
        ],
        "additionalProperties": false
      },
      "UnisoftRequest_95afed61f212b9c25f46": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "enum": [
              0
            ]
          },
          "url": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2048,
            "pattern": "^[hH][tT][tT][pP][sS]://",
            "format": "uri",
            "description": "URL de callback HTTPS sans informations utilisateur ni fragment. Le propriétaire refuse les cibles privées, les redirections et les DNS non qualifiés. Valeur sensible : ne jamais la journaliser ni la répéter."
          },
          "signingSecret": {
            "type": "string",
            "minLength": 43,
            "maxLength": 256,
            "pattern": "^[A-Za-z0-9_-]{43,256}$",
            "description": "Secret de signature base64url fourni par l’appelant, d’au moins 43 caractères. Écriture seule : ne jamais le répéter dans une réponse, un prompt, un journal ou une requête ultérieure, sauf rotation volontaire."
          },
          "eventTypes": {
            "type": "array",
            "minItems": 1,
            "maxItems": 2,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "insight.analysis.ready",
                "insight.weekly.ready"
              ]
            },
            "description": "Choix explicite des événements. Omission à la création : analyses seules. L’ajout hebdomadaire exige insight:weekly:read courant ; omission en modification conserve le choix existant. Aucun ancien grant ou destination ne gagne ce type implicitement."
          }
        },
        "required": [
          "operationKey",
          "expectedRevision",
          "url",
          "signingSecret"
        ],
        "additionalProperties": false
      },
      "InsightWebhookReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWebhookReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWebhookReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "create",
              "update",
              "remove"
            ]
          },
          "destinationId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "appliedRevision": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "appliedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "action",
          "destinationId",
          "operationKey",
          "expectedRevision",
          "appliedRevision",
          "appliedAt"
        ]
      },
      "InsightWebhookError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "InsightWebhookListResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWebhookList"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWebhookList": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "items": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "eventTypes": {
                  "type": "array",
                  "minItems": 1,
                  "maxItems": 2,
                  "uniqueItems": true,
                  "items": {
                    "type": "string",
                    "enum": [
                      "insight.analysis.ready",
                      "insight.weekly.ready"
                    ]
                  },
                  "description": "Choix explicite des événements. Omission à la création : analyses seules. L’ajout hebdomadaire exige insight:weekly:read courant ; omission en modification conserve le choix existant. Aucun ancien grant ou destination ne gagne ce type implicitement."
                },
                "destinationId": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                },
                "revision": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740990
                },
                "endpointOrigin": {
                  "type": "string",
                  "format": "uri",
                  "maxLength": 2048,
                  "pattern": "^https://"
                },
                "active": {
                  "type": "boolean"
                },
                "updatedAt": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "required": [
                "eventTypes",
                "destinationId",
                "revision",
                "endpointOrigin",
                "active",
                "updatedAt"
              ]
            }
          },
          "hasMore": {
            "type": "boolean"
          },
          "nextCursor": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "nullable": true
          }
        },
        "required": [
          "items",
          "hasMore",
          "nextCursor"
        ]
      },
      "InsightWebhookDestinationResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWebhookDestination"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWebhookDestination": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "eventTypes": {
            "type": "array",
            "minItems": 1,
            "maxItems": 2,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "insight.analysis.ready",
                "insight.weekly.ready"
              ]
            },
            "description": "Choix explicite des événements. Omission à la création : analyses seules. L’ajout hebdomadaire exige insight:weekly:read courant ; omission en modification conserve le choix existant. Aucun ancien grant ou destination ne gagne ce type implicitement."
          },
          "destinationId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "revision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740990
          },
          "endpointOrigin": {
            "type": "string",
            "format": "uri",
            "maxLength": 2048,
            "pattern": "^https://"
          },
          "active": {
            "type": "boolean"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "eventTypes",
          "destinationId",
          "revision",
          "endpointOrigin",
          "active",
          "updatedAt"
        ]
      },
      "UnisoftRequest_3e0880e63a0e8aadb9d7": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "url": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2048,
            "pattern": "^[hH][tT][tT][pP][sS]://",
            "format": "uri",
            "description": "URL de callback HTTPS sans informations utilisateur ni fragment. Le propriétaire refuse les cibles privées, les redirections et les DNS non qualifiés. Valeur sensible : ne jamais la journaliser ni la répéter."
          },
          "signingSecret": {
            "type": "string",
            "minLength": 43,
            "maxLength": 256,
            "pattern": "^[A-Za-z0-9_-]{43,256}$",
            "description": "Secret de signature base64url fourni par l’appelant, d’au moins 43 caractères. Écriture seule : ne jamais le répéter dans une réponse, un prompt, un journal ou une requête ultérieure, sauf rotation volontaire."
          },
          "active": {
            "type": "boolean"
          },
          "eventTypes": {
            "type": "array",
            "minItems": 1,
            "maxItems": 2,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "insight.analysis.ready",
                "insight.weekly.ready"
              ]
            },
            "description": "Choix explicite des événements. Omission à la création : analyses seules. L’ajout hebdomadaire exige insight:weekly:read courant ; omission en modification conserve le choix existant. Aucun ancien grant ou destination ne gagne ce type implicitement."
          }
        },
        "required": [
          "operationKey",
          "expectedRevision"
        ],
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "url"
            ]
          },
          {
            "required": [
              "signingSecret"
            ]
          },
          {
            "required": [
              "active"
            ]
          },
          {
            "required": [
              "eventTypes"
            ]
          }
        ]
      },
      "InsightWeeklyPreferencesResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyPreferences"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyPreferences": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "revision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740990
          },
          "schedule": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "weekday": {
                "type": "integer",
                "minimum": 0,
                "maximum": 6,
                "description": "0=dimanche, 1=lundi, …, 6=samedi."
              },
              "localTime": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              },
              "timeZone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$",
                "description": "Fuseau IANA valide explicite ; jamais déduit de la langue ou du nom de l’organisation."
              }
            },
            "required": [
              "weekday",
              "localTime",
              "timeZone"
            ],
            "nullable": true
          },
          "language": {
            "type": "string",
            "enum": [
              "fr",
              "en",
              "he",
              "de",
              "es",
              "gr",
              "ro",
              null
            ],
            "nullable": true
          },
          "emailEnabled": {
            "type": "boolean"
          },
          "availabilityNoticeEnabled": {
            "type": "boolean"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "required": [
          "revision",
          "schedule",
          "language",
          "emailEnabled",
          "availabilityNoticeEnabled",
          "updatedAt"
        ]
      },
      "InsightWeeklyError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "UnisoftRequest_225b2a9e388335330940": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "schedule": {
            "type": "object",
            "properties": {
              "weekday": {
                "type": "integer",
                "minimum": 0,
                "maximum": 6,
                "description": "0=dimanche, 1=lundi, …, 6=samedi."
              },
              "localTime": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              },
              "timeZone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$",
                "description": "Fuseau IANA valide explicite ; jamais déduit de la langue ou du nom de l’organisation."
              }
            },
            "required": [
              "weekday",
              "localTime",
              "timeZone"
            ],
            "additionalProperties": false,
            "nullable": true
          },
          "language": {
            "type": "string",
            "enum": [
              "fr",
              "en",
              "he",
              "de",
              "es",
              "gr",
              "ro",
              null
            ],
            "nullable": true
          },
          "emailEnabled": {
            "type": "boolean"
          },
          "availabilityNoticeEnabled": {
            "type": "boolean"
          }
        },
        "required": [
          "operationKey",
          "expectedRevision"
        ],
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "schedule"
            ]
          },
          {
            "required": [
              "language"
            ]
          },
          {
            "required": [
              "emailEnabled"
            ]
          },
          {
            "required": [
              "availabilityNoticeEnabled"
            ]
          }
        ]
      },
      "InsightWeeklyPreferencesReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyPreferencesReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyPreferencesReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "saveWeeklyPreferences"
            ]
          },
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "appliedRevision": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "appliedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "action",
          "operationKey",
          "expectedRevision",
          "appliedRevision",
          "appliedAt"
        ]
      },
      "InsightWeeklyReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          },
          "action": {
            "type": "string",
            "enum": [
              "request"
            ]
          },
          "occurrenceId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "status": {
            "type": "string",
            "enum": [
              "queued"
            ]
          },
          "acceptedAt": {
            "type": "string",
            "format": "date-time"
          },
          "preferenceRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740990
          }
        },
        "required": [
          "operationKey",
          "action",
          "occurrenceId",
          "status",
          "acceptedAt",
          "preferenceRevision"
        ]
      },
      "InsightWeeklyListResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyList"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyList": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "reportId": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                },
                "reportVersion": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 9007199254740990
                },
                "occurrence": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "occurrenceId": {
                      "type": "string",
                      "pattern": "^[a-f0-9]{64}$"
                    },
                    "preferenceRevision": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740990
                    },
                    "calendarVersion": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 9007199254740990
                    },
                    "localDate": {
                      "type": "string",
                      "format": "date",
                      "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$"
                    },
                    "localTime": {
                      "type": "string",
                      "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
                    },
                    "timeZone": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100,
                      "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$",
                      "description": "Fuseau IANA valide explicite ; jamais déduit de la langue ou du nom de l’organisation."
                    },
                    "scheduledAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "prepareAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "period": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "from": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "to": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "startAdjustment": {
                          "type": "string",
                          "enum": [
                            "gap_to_first_existing_instant",
                            null
                          ],
                          "nullable": true
                        },
                        "coverage": {
                          "type": "string",
                          "enum": [
                            "civil_boundary_adjusted",
                            "theoretical_civil_week"
                          ]
                        }
                      },
                      "required": [
                        "from",
                        "to",
                        "startAdjustment",
                        "coverage"
                      ]
                    },
                    "language": {
                      "type": "string",
                      "enum": [
                        "fr",
                        "en",
                        "he",
                        "de",
                        "es",
                        "gr",
                        "ro"
                      ]
                    }
                  },
                  "required": [
                    "occurrenceId",
                    "preferenceRevision",
                    "calendarVersion",
                    "localDate",
                    "localTime",
                    "timeZone",
                    "scheduledAt",
                    "prepareAt",
                    "period",
                    "language"
                  ]
                },
                "preparedAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "publishedAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "language": {
                  "type": "string",
                  "enum": [
                    "fr",
                    "en",
                    "he",
                    "de",
                    "es",
                    "gr",
                    "ro"
                  ]
                }
              },
              "required": [
                "reportId",
                "reportVersion",
                "occurrence",
                "preparedAt",
                "publishedAt",
                "language"
              ]
            },
            "maxItems": 20
          },
          "hasMore": {
            "type": "boolean"
          },
          "nextCursor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1500,
            "nullable": true
          }
        },
        "required": [
          "items",
          "hasMore",
          "nextCursor"
        ]
      },
      "InsightWeeklyStatusResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyStatus"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyStatus": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "incomplete",
              "scheduled",
              "queued",
              "running",
              "budget_waiting",
              "prepared",
              "ready",
              "stale",
              "failed"
            ]
          },
          "occurrence": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "occurrenceId": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "preferenceRevision": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740990
              },
              "calendarVersion": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740990
              },
              "localDate": {
                "type": "string",
                "format": "date",
                "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$"
              },
              "localTime": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              },
              "timeZone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$",
                "description": "Fuseau IANA valide explicite ; jamais déduit de la langue ou du nom de l’organisation."
              },
              "scheduledAt": {
                "type": "string",
                "format": "date-time"
              },
              "prepareAt": {
                "type": "string",
                "format": "date-time"
              },
              "period": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "from": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "to": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "startAdjustment": {
                    "type": "string",
                    "enum": [
                      "gap_to_first_existing_instant",
                      null
                    ],
                    "nullable": true
                  },
                  "coverage": {
                    "type": "string",
                    "enum": [
                      "civil_boundary_adjusted",
                      "theoretical_civil_week"
                    ]
                  }
                },
                "required": [
                  "from",
                  "to",
                  "startAdjustment",
                  "coverage"
                ]
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ]
              }
            },
            "required": [
              "occurrenceId",
              "preferenceRevision",
              "calendarVersion",
              "localDate",
              "localTime",
              "timeZone",
              "scheduledAt",
              "prepareAt",
              "period",
              "language"
            ],
            "nullable": true
          },
          "report": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "reportId": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "reportVersion": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740990
              }
            },
            "required": [
              "reportId",
              "reportVersion"
            ],
            "nullable": true
          },
          "error": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "INSIGHT_WEEKLY_SCHEDULE_REQUIRED",
                  "INSIGHT_WEEKLY_LANGUAGE_REQUIRED",
                  "INSIGHT_WEEKLY_CALENDAR_UNAVAILABLE",
                  "INSIGHT_WEEKLY_PREFERENCE_CHANGED",
                  "INSIGHT_WEEKLY_CLAIM_LOST",
                  "INSIGHT_WEEKLY_UNAVAILABLE",
                  "INSIGHT_WEEKLY_CAPACITY",
                  "INSIGHT_WEEKLY_ANALYSIS_STALE",
                  "INSIGHT_WEEKLY_ANALYSIS_FORBIDDEN",
                  "INSIGHT_WEEKLY_ANALYSIS_UNAVAILABLE",
                  "INSIGHT_WEEKLY_ANALYSIS_INPUT_INVALID",
                  "INSIGHT_FORBIDDEN",
                  "INSIGHT_INPUT_INVALID"
                ]
              }
            },
            "required": [
              "code"
            ],
            "nullable": true
          }
        },
        "required": [
          "status",
          "occurrence",
          "report",
          "error"
        ]
      },
      "InsightWeeklyReportResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyReport"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyReport": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "ready",
              "unavailable"
            ]
          },
          "reportId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "reportVersion": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "occurrence": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "occurrenceId": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "preferenceRevision": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740990
              },
              "calendarVersion": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740990
              },
              "localDate": {
                "type": "string",
                "format": "date",
                "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$"
              },
              "localTime": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              },
              "timeZone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$",
                "description": "Fuseau IANA valide explicite ; jamais déduit de la langue ou du nom de l’organisation."
              },
              "scheduledAt": {
                "type": "string",
                "format": "date-time"
              },
              "prepareAt": {
                "type": "string",
                "format": "date-time"
              },
              "period": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "from": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "to": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "startAdjustment": {
                    "type": "string",
                    "enum": [
                      "gap_to_first_existing_instant",
                      null
                    ],
                    "nullable": true
                  },
                  "coverage": {
                    "type": "string",
                    "enum": [
                      "civil_boundary_adjusted",
                      "theoretical_civil_week"
                    ]
                  }
                },
                "required": [
                  "from",
                  "to",
                  "startAdjustment",
                  "coverage"
                ]
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ]
              }
            },
            "required": [
              "occurrenceId",
              "preferenceRevision",
              "calendarVersion",
              "localDate",
              "localTime",
              "timeZone",
              "scheduledAt",
              "prepareAt",
              "period",
              "language"
            ]
          },
          "preparedAt": {
            "type": "string",
            "format": "date-time"
          },
          "publishedAt": {
            "type": "string",
            "format": "date-time"
          },
          "language": {
            "type": "string",
            "enum": [
              "fr",
              "en",
              "he",
              "de",
              "es",
              "gr",
              "ro"
            ]
          },
          "frame": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "revision": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "common": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740990
                  },
                  "personal": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740990
                  }
                },
                "required": [
                  "common",
                  "personal"
                ]
              },
              "mission": {
                "type": "string",
                "maxLength": 8000
              },
              "audience": {
                "type": "string",
                "maxLength": 8000
              },
              "primaryPriority": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "type": "string",
                    "maxLength": 100,
                    "minLength": 1
                  },
                  "text": {
                    "type": "string",
                    "maxLength": 4000,
                    "minLength": 1
                  },
                  "dueOn": {
                    "type": "string",
                    "format": "date",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                    "nullable": true
                  }
                },
                "required": [
                  "id",
                  "text",
                  "dueOn"
                ],
                "nullable": true
              },
              "secondaryPriorities": {
                "type": "array",
                "maxItems": 20,
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 100,
                      "minLength": 1
                    },
                    "text": {
                      "type": "string",
                      "maxLength": 4000,
                      "minLength": 1
                    },
                    "dueOn": {
                      "type": "string",
                      "format": "date",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                      "nullable": true
                    }
                  },
                  "required": [
                    "id",
                    "text",
                    "dueOn"
                  ]
                }
              }
            },
            "required": [
              "revision",
              "mission",
              "audience",
              "primaryPriority",
              "secondaryPriorities"
            ],
            "nullable": true
          },
          "comparison": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "comparable",
                  "unavailable"
                ]
              },
              "baseline": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "reportId": {
                    "type": "string",
                    "pattern": "^[a-f0-9]{64}$"
                  },
                  "reportVersion": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9007199254740990
                  }
                },
                "required": [
                  "reportId",
                  "reportVersion"
                ],
                "nullable": true
              },
              "reasonCodes": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "maxItems": 100
              },
              "changes": {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "declared_priority_changed"
                          ]
                        },
                        "nature": {
                          "type": "string",
                          "enum": [
                            "declared"
                          ]
                        },
                        "source": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "collection": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200
                            }
                          },
                          "required": [
                            "collection",
                            "id"
                          ]
                        },
                        "limits": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          },
                          "maxItems": 100
                        },
                        "details": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "before": {
                              "type": "object",
                              "additionalProperties": false,
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "maxLength": 100,
                                  "minLength": 1
                                },
                                "text": {
                                  "type": "string",
                                  "maxLength": 4000,
                                  "minLength": 1
                                },
                                "dueOn": {
                                  "type": "string",
                                  "format": "date",
                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                                  "nullable": true
                                }
                              },
                              "required": [
                                "id",
                                "text",
                                "dueOn"
                              ],
                              "nullable": true
                            },
                            "after": {
                              "type": "object",
                              "additionalProperties": false,
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "maxLength": 100,
                                  "minLength": 1
                                },
                                "text": {
                                  "type": "string",
                                  "maxLength": 4000,
                                  "minLength": 1
                                },
                                "dueOn": {
                                  "type": "string",
                                  "format": "date",
                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                                  "nullable": true
                                }
                              },
                              "required": [
                                "id",
                                "text",
                                "dueOn"
                              ],
                              "nullable": true
                            }
                          },
                          "required": [
                            "before",
                            "after"
                          ]
                        }
                      },
                      "required": [
                        "kind",
                        "nature",
                        "source",
                        "limits",
                        "details"
                      ]
                    },
                    {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "appeared_in_admitted_data"
                          ]
                        },
                        "nature": {
                          "type": "string",
                          "enum": [
                            "recorded_fact",
                            "prepared_suggestion"
                          ]
                        },
                        "source": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "collection": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200
                            }
                          },
                          "required": [
                            "collection",
                            "id"
                          ]
                        },
                        "limits": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          },
                          "maxItems": 100
                        },
                        "details": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "subject": {
                              "type": "object",
                              "additionalProperties": false,
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "enum": [
                                    "contact",
                                    "event",
                                    "priority",
                                    "resources",
                                    "calendar",
                                    "activities"
                                  ]
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 4000,
                                  "pattern": "\\S"
                                }
                              },
                              "required": [
                                "kind",
                                "label"
                              ],
                              "nullable": true
                            },
                            "observedAt": {
                              "type": "string",
                              "format": "date-time",
                              "nullable": true
                            },
                            "occurredAt": {
                              "type": "string",
                              "format": "date-time",
                              "nullable": true
                            },
                            "occurredOn": {
                              "type": "string",
                              "format": "date",
                              "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                              "nullable": true
                            },
                            "datePrecision": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "pattern": "^[A-Za-z0-9_:.\\-]+$"
                            }
                          },
                          "required": [
                            "subject",
                            "observedAt",
                            "occurredAt",
                            "occurredOn",
                            "datePrecision"
                          ]
                        }
                      },
                      "required": [
                        "kind",
                        "nature",
                        "source",
                        "limits",
                        "details"
                      ]
                    },
                    {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "review_declared"
                          ]
                        },
                        "nature": {
                          "type": "string",
                          "enum": [
                            "declared"
                          ]
                        },
                        "source": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "collection": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200
                            }
                          },
                          "required": [
                            "collection",
                            "id"
                          ]
                        },
                        "limits": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          },
                          "maxItems": 100
                        },
                        "details": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "declarationKind": {
                              "type": "string",
                              "enum": [
                                "done",
                                "not_relevant",
                                "defer"
                              ]
                            },
                            "declaredAt": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "subject": {
                              "type": "object",
                              "additionalProperties": false,
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "enum": [
                                    "contact",
                                    "event",
                                    "priority",
                                    "resources",
                                    "calendar",
                                    "activities"
                                  ]
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 4000,
                                  "pattern": "\\S"
                                }
                              },
                              "required": [
                                "kind",
                                "label"
                              ],
                              "nullable": true
                            }
                          },
                          "required": [
                            "declarationKind",
                            "declaredAt",
                            "subject"
                          ]
                        }
                      },
                      "required": [
                        "kind",
                        "nature",
                        "source",
                        "limits",
                        "details"
                      ]
                    }
                  ]
                },
                "maxItems": 3
              }
            },
            "required": [
              "status",
              "baseline",
              "reasonCodes",
              "changes"
            ]
          },
          "coverage": {
            "oneOf": [
              {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "complete",
                      "partial",
                      "unknown"
                    ]
                  },
                  "sources": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "family": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200,
                          "pattern": "^[A-Za-z0-9_:.\\-]+$"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "available",
                            "partial",
                            "unavailable",
                            "forbidden",
                            "unknown"
                          ]
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "nullable": true
                        },
                        "limits": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          },
                          "maxItems": 100
                        }
                      },
                      "required": [
                        "family",
                        "status",
                        "count",
                        "limits"
                      ]
                    },
                    "maxItems": 30
                  },
                  "limits": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "maxItems": 100
                  },
                  "localDate": {
                    "type": "string",
                    "format": "date",
                    "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                    "nullable": true
                  },
                  "calendarReview": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$"
                  }
                },
                "required": [
                  "status",
                  "sources",
                  "limits",
                  "localDate",
                  "calendarReview"
                ]
              },
              {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "unavailable"
                    ]
                  },
                  "limits": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "maxItems": 100
                  }
                },
                "required": [
                  "status",
                  "limits"
                ]
              }
            ]
          },
          "result": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "version": {
                "type": "integer",
                "enum": [
                  1
                ]
              },
              "status": {
                "type": "string",
                "enum": [
                  "ready"
                ]
              },
              "generatedAt": {
                "type": "string",
                "format": "date-time"
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ],
                "description": "Langue de l’API : fr français, en anglais, he hébreu, de allemand, es espagnol, gr grec, ro roumain. Si la langue est omise, la valeur par défaut est fr."
              },
              "frameRevision": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "common": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "personal": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "common",
                  "personal"
                ]
              },
              "summary": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2400
                  },
                  "evidenceIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "maxItems": 100,
                    "uniqueItems": true
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "facts_only",
                      "admitted_topics"
                    ]
                  }
                },
                "required": [
                  "text",
                  "evidenceIds",
                  "mode"
                ]
              },
              "topics": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 250
                    },
                    "family": {
                      "type": "string",
                      "enum": [
                        "documented_attention",
                        "event_opportunity",
                        "priority_review",
                        "recorded_relationship",
                        "recorded_resources",
                        "calendar_preparation",
                        "relationship_continuity",
                        "activity_history"
                      ]
                    },
                    "title": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "conclusion": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "reason": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "proposal": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "text": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1200
                        },
                        "kind": {
                          "type": "string",
                          "enum": [
                            "human_review"
                          ]
                        },
                        "targetId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "text",
                        "kind",
                        "targetId"
                      ]
                    },
                    "evidenceIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "maxItems": 100,
                      "uniqueItems": true
                    },
                    "priorityIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "maxItems": 100,
                      "uniqueItems": true
                    },
                    "caveats": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    },
                    "reviewAction": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "type": {
                          "type": "string",
                          "enum": [
                            "review_documented_need",
                            "review_event_fit",
                            "reassess_priority",
                            "review_recorded_exchange",
                            "review_recorded_resources",
                            "review_calendar_preparation",
                            "review_relationship_continuity",
                            "review_activity_history"
                          ]
                        },
                        "targetId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "id",
                        "type",
                        "targetId"
                      ]
                    },
                    "reappearance": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "text": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 800
                        },
                        "evidenceIds": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "maxItems": 100,
                          "uniqueItems": true
                        }
                      },
                      "required": [
                        "text",
                        "evidenceIds"
                      ],
                      "nullable": true
                    }
                  },
                  "required": [
                    "id",
                    "family",
                    "title",
                    "conclusion",
                    "reason",
                    "proposal",
                    "evidenceIds",
                    "priorityIds",
                    "caveats",
                    "reviewAction",
                    "reappearance"
                  ]
                },
                "maxItems": 3
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "nature": {
                      "type": "string",
                      "enum": [
                        "declared",
                        "recorded_fact",
                        "prepared_suggestion"
                      ]
                    },
                    "source": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "collection": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "collection",
                        "id"
                      ],
                      "nullable": true
                    },
                    "contactId": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "nullable": true
                    },
                    "observedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "occurredAt": {
                      "type": "string",
                      "format": "date-time",
                      "nullable": true
                    },
                    "occurredOn": {
                      "type": "string",
                      "format": "date",
                      "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                      "nullable": true
                    },
                    "datePrecision": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "labelCode": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "text": {
                      "type": "string",
                      "minLength": 0,
                      "maxLength": 16000
                    },
                    "facts": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "code": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$",
                            "description": "Fait typé admis. contact_marked_local est true/false/null pour le marquage local actuel, pas une localisation physique. registration_count compte les contacts inscrits admis, pas des familles ni des présences. La couverture ne mesure pas l’avancement des préparatifs. Faits des sources étendues DEV : recorded_interaction est une trace CRM datée, pas un besoin non satisfait prouvé. recorded_resources sépare les devises et deux périodes UTC complètes de 30 jours excluant la journée courante ; l’unité monétaire minor:CODE:EXP signifie diviser par 10^EXP. Des totaux null indiquent des données non qualifiées ou exclues, jamais zéro. Ce sont des paiements bruts enregistrés, pas une trésorerie disponible, uniquement des dons, un règlement bancaire ou un budget de projet. community_calendar est une échéance civile calculée, pas une disponibilité personnelle ni un préparatif manquant. Les vues DEV relationship_history et activity_history exigent conjointement contacts, events et registrations. firstVisibleRegistrationAt désigne la première inscription validée visible dans la fenêtre de 180 jours, pas le début réel de la relation. laterRecordedInteractionCount compte les traces instantanées strictement ultérieures ; une précision au jour ne prouve pas l’ordre. Les activités sont réparties par début enregistré de l’événement, pas par création d’inscription, sur deux périodes UTC complètes de 90 jours. Contacts distincts, couples contact–événement et moyennes par événement sont des unités différentes. comparisonAvailable=false interdit une comparaison de tendance. Les identifiants sources synthétiques insight_relationship_history et insight_activity_history sont des projections opaques, pas des identifiants d’événement. Un même groupe explicite ne prouve pas des formats/publics identiques, une présence, fidélité ou efficacité causale. Les inscriptions valides archivées sont incluses dans leur état actuel ; aucune photographie historique immuable n’est implicite. Les bornes from/splitAt/to sont des bornes UTC semi-ouvertes ; la fin est exclue. La continuité sans inscription est aussi admise : firstVisibleInteractionAt/lastVisibleInteractionAt et laterRecordedExchangeCount se réfèrent au premier échange instantané visible. laterRecordedInteractionCount reste relatif à la première inscription visible et vaut null sans celle-ci. firstEverContactAt/firstEverRegistrationAt restent inconnus. registrationChronologyKnown=false masque les mesures d’inscription sans inventer zéro ni supprimer les échanges datés qualifiés."
                          },
                          "value": {
                            "oneOf": [
                              {
                                "type": "string",
                                "maxLength": 16000
                              },
                              {
                                "type": "number"
                              },
                              {
                                "type": "boolean"
                              },
                              {
                                "type": "string",
                                "nullable": true,
                                "enum": [
                                  null
                                ]
                              }
                            ]
                          },
                          "unit": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100,
                            "nullable": true
                          }
                        },
                        "required": [
                          "code",
                          "value",
                          "unit"
                        ]
                      },
                      "maxItems": 100
                    },
                    "references": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "collection": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "id": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "contactId": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "nullable": true
                          },
                          "quote": {
                            "type": "string",
                            "minLength": 0,
                            "maxLength": 10000,
                            "nullable": true
                          },
                          "at": {
                            "type": "string",
                            "format": "date-time",
                            "nullable": true
                          },
                          "occurredOn": {
                            "type": "string",
                            "format": "date",
                            "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                            "nullable": true
                          },
                          "datePrecision": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          }
                        },
                        "required": [
                          "collection",
                          "id",
                          "contactId",
                          "quote",
                          "at",
                          "occurredOn",
                          "datePrecision"
                        ]
                      },
                      "maxItems": 100
                    },
                    "limits": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    }
                  },
                  "required": [
                    "id",
                    "nature",
                    "source",
                    "contactId",
                    "observedAt",
                    "occurredAt",
                    "occurredOn",
                    "datePrecision",
                    "labelCode",
                    "text",
                    "facts",
                    "references",
                    "limits"
                  ]
                },
                "maxItems": 120
              },
              "clarifications": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "text": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 500
                    }
                  },
                  "required": [
                    "text"
                  ]
                },
                "maxItems": 1
              },
              "coverage": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "complete",
                      "partial",
                      "unknown"
                    ]
                  },
                  "sources": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "family": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200,
                          "pattern": "^[A-Za-z0-9_:.\\-]+$"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "available",
                            "partial",
                            "unavailable",
                            "forbidden",
                            "unknown"
                          ]
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "nullable": true
                        },
                        "limits": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          },
                          "maxItems": 100
                        }
                      },
                      "required": [
                        "family",
                        "status",
                        "count",
                        "limits"
                      ]
                    },
                    "maxItems": 30
                  },
                  "limits": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "maxItems": 100
                  },
                  "localDate": {
                    "type": "string",
                    "format": "date",
                    "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                    "nullable": true
                  },
                  "calendarReview": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$"
                  }
                },
                "required": [
                  "status",
                  "sources",
                  "limits",
                  "localDate",
                  "calendarReview"
                ]
              },
              "privacy": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "classification": {
                    "type": "string",
                    "enum": [
                      "personal"
                    ]
                  },
                  "privateDependencies": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "personal_frame",
                        "constraints",
                        "enrichment"
                      ]
                    },
                    "maxItems": 3,
                    "uniqueItems": true
                  }
                },
                "required": [
                  "classification",
                  "privateDependencies"
                ]
              }
            },
            "required": [
              "version",
              "status",
              "generatedAt",
              "language",
              "frameRevision",
              "summary",
              "topics",
              "evidence",
              "clarifications",
              "coverage",
              "privacy"
            ],
            "nullable": true
          },
          "privacy": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "classification": {
                "type": "string",
                "enum": [
                  "personal"
                ]
              }
            },
            "required": [
              "classification"
            ]
          }
        },
        "required": [
          "status",
          "reportId",
          "reportVersion",
          "occurrence",
          "preparedAt",
          "publishedAt",
          "language",
          "frame",
          "comparison",
          "coverage",
          "result",
          "privacy"
        ]
      },
      "InsightWeeklyPdfReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyPdfReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyPdfReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          },
          "documentId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "reportId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "reportVersion": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "projection": {
            "type": "string",
            "enum": [
              "shareable"
            ]
          },
          "acceptedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "operationKey",
          "documentId",
          "reportId",
          "reportVersion",
          "projection",
          "acceptedAt"
        ]
      },
      "InsightWeeklyPdfError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "InsightWeeklyPdfMetadataResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyPdfMetadata"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyPdfMetadata": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "documentId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "reportId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "reportVersion": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "projection": {
            "type": "string",
            "enum": [
              "shareable"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "queued",
              "running",
              "ready",
              "refused",
              "failed"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "contentDigest": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "nullable": true
          },
          "sha256": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "nullable": true
          },
          "bytes": {
            "type": "integer",
            "minimum": 5,
            "maximum": 4194304,
            "nullable": true
          },
          "filename": {
            "type": "string",
            "minLength": 5,
            "maxLength": 180,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]*\\.pdf$",
            "nullable": true
          }
        },
        "required": [
          "documentId",
          "reportId",
          "reportVersion",
          "projection",
          "state",
          "createdAt",
          "updatedAt",
          "contentDigest",
          "sha256",
          "bytes",
          "filename"
        ]
      },
      "InsightWeeklyPdfPreviewResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyPdfPreview"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyPdfPreview": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "purpose": {
            "type": "string",
            "enum": [
              "shareable"
            ]
          },
          "reportRef": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "reportId": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "reportVersion": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740990
              }
            },
            "required": [
              "reportId",
              "reportVersion"
            ]
          },
          "projectionRef": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "documentId": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "projectionVersion": {
                "type": "integer",
                "enum": [
                  1
                ]
              }
            },
            "required": [
              "documentId",
              "projectionVersion"
            ]
          },
          "inputVersion": {
            "type": "integer",
            "enum": [
              1
            ]
          },
          "contentDigest": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "coverage": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "complete",
                  "partial",
                  "unknown",
                  "unavailable"
                ]
              }
            },
            "required": [
              "status"
            ]
          },
          "omissions": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200,
              "pattern": "^[A-Za-z0-9_:.\\-]+$"
            }
          },
          "content": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "version": {
                "type": "integer",
                "enum": [
                  1
                ]
              },
              "brand": {
                "type": "string",
                "enum": [
                  "Unisoft"
                ]
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ]
              },
              "labels": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "period": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "observedAt": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "attention": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "conclusion": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "reason": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "proposal": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "coverage": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "omissions": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "footer": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "privacyNotice": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "coveragePartial": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  }
                },
                "required": [
                  "title",
                  "period",
                  "observedAt",
                  "summary",
                  "attention",
                  "conclusion",
                  "reason",
                  "proposal",
                  "coverage",
                  "omissions",
                  "footer",
                  "privacyNotice",
                  "coveragePartial"
                ]
              },
              "period": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "from": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "to": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "localFrom": {
                    "type": "string",
                    "format": "date"
                  },
                  "localTo": {
                    "type": "string",
                    "format": "date"
                  },
                  "timeZone": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  }
                },
                "required": [
                  "from",
                  "to",
                  "localFrom",
                  "localTo",
                  "timeZone"
                ]
              },
              "preparedAt": {
                "type": "string",
                "format": "date-time"
              },
              "publishedAt": {
                "type": "string",
                "format": "date-time"
              },
              "summary": {
                "type": "string",
                "minLength": 1,
                "maxLength": 2400
              },
              "topics": {
                "type": "array",
                "maxItems": 3,
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "title": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "conclusion": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "reason": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "proposal": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    }
                  },
                  "required": [
                    "title",
                    "conclusion",
                    "reason",
                    "proposal"
                  ]
                }
              },
              "coveragePartial": {
                "type": "boolean"
              },
              "privacyNotice": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000
              }
            },
            "required": [
              "version",
              "brand",
              "language",
              "labels",
              "period",
              "preparedAt",
              "publishedAt",
              "summary",
              "topics",
              "coveragePartial",
              "privacyNotice"
            ]
          }
        },
        "required": [
          "purpose",
          "reportRef",
          "projectionRef",
          "inputVersion",
          "contentDigest",
          "coverage",
          "omissions",
          "content"
        ]
      },
      "InsightWeeklyPdfContentResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyPdfContent"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyPdfContent": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "documentId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "mimeType": {
            "type": "string",
            "enum": [
              "application/pdf"
            ]
          },
          "filename": {
            "type": "string",
            "minLength": 5,
            "maxLength": 180,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]*\\.pdf$"
          },
          "bytes": {
            "type": "integer",
            "minimum": 5,
            "maximum": 4194304
          },
          "sha256": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "contentBase64": {
            "type": "string",
            "maxLength": 5592408,
            "pattern": "^[A-Za-z0-9+/]*={0,2}$"
          }
        },
        "required": [
          "documentId",
          "mimeType",
          "filename",
          "bytes",
          "sha256",
          "contentBase64"
        ]
      },
      "InsightNotificationsPreferencesResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightNotificationsPreferences"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightNotificationsPreferences": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "revision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "alertsEnabled": {
            "type": "boolean"
          },
          "timeZone": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$",
            "nullable": true
          },
          "nightEnabled": {
            "type": "boolean",
            "nullable": true
          },
          "quietHours": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "from": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              },
              "to": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              }
            },
            "required": [
              "from",
              "to"
            ],
            "nullable": true
          },
          "shabbatEnabled": {
            "type": "boolean"
          },
          "holidaysEnabled": {
            "type": "boolean"
          },
          "location": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "\\S"
              },
              "latitude": {
                "type": "number",
                "minimum": -90,
                "maximum": 90
              },
              "longitude": {
                "type": "number",
                "minimum": -180,
                "maximum": 180
              },
              "country": {
                "type": "string",
                "pattern": "^[A-Z]{2}$"
              },
              "israel": {
                "type": "boolean"
              },
              "timeZone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$"
              },
              "confirmed": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "basis": {
                "type": "string",
                "enum": [
                  "declared_city"
                ]
              }
            },
            "required": [
              "label",
              "latitude",
              "longitude",
              "country",
              "israel",
              "timeZone",
              "confirmed",
              "basis"
            ],
            "nullable": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "required": [
          "revision",
          "alertsEnabled",
          "timeZone",
          "nightEnabled",
          "quietHours",
          "shabbatEnabled",
          "holidaysEnabled",
          "location",
          "updatedAt"
        ]
      },
      "InsightNotificationsError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "UnisoftRequest_e507089f51f89fe39e78": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "alertsEnabled": {
            "type": "boolean"
          },
          "timeZone": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$",
            "nullable": true
          },
          "nightEnabled": {
            "type": "boolean",
            "nullable": true
          },
          "quietHours": {
            "type": "object",
            "properties": {
              "from": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              },
              "to": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              }
            },
            "required": [
              "from",
              "to"
            ],
            "additionalProperties": false,
            "nullable": true
          },
          "shabbatEnabled": {
            "type": "boolean"
          },
          "holidaysEnabled": {
            "type": "boolean"
          },
          "location": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "\\S"
              },
              "latitude": {
                "type": "number",
                "minimum": -90,
                "maximum": 90
              },
              "longitude": {
                "type": "number",
                "minimum": -180,
                "maximum": 180
              },
              "country": {
                "type": "string",
                "pattern": "^[A-Z]{2}$"
              },
              "israel": {
                "type": "boolean"
              },
              "timeZone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$"
              },
              "confirmed": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "basis": {
                "type": "string",
                "enum": [
                  "declared_city"
                ]
              }
            },
            "required": [
              "label",
              "latitude",
              "longitude",
              "country",
              "israel",
              "timeZone",
              "confirmed",
              "basis"
            ],
            "additionalProperties": false,
            "nullable": true
          }
        },
        "required": [
          "operationKey",
          "expectedRevision"
        ],
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "alertsEnabled"
            ]
          },
          {
            "required": [
              "timeZone"
            ]
          },
          {
            "required": [
              "nightEnabled"
            ]
          },
          {
            "required": [
              "quietHours"
            ]
          },
          {
            "required": [
              "shabbatEnabled"
            ]
          },
          {
            "required": [
              "holidaysEnabled"
            ]
          },
          {
            "required": [
              "location"
            ]
          }
        ]
      },
      "InsightNotificationsReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightNotificationsReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightNotificationsReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "saveDeliveryPreferences"
            ]
          },
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "appliedRevision": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740989
          },
          "appliedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "action",
          "operationKey",
          "expectedRevision",
          "appliedRevision",
          "appliedAt"
        ]
      },
      "InsightNotificationsStatusResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightNotificationsStatus"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightNotificationsStatus": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "families": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "alert": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "enabled": {
                    "type": "boolean"
                  },
                  "optedIn": {
                    "type": "boolean"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "allowed",
                      "deferred",
                      "unknown",
                      "refused",
                      "disabled"
                    ]
                  },
                  "reason": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$",
                    "nullable": true
                  },
                  "retryAt": {
                    "type": "string",
                    "format": "date-time",
                    "nullable": true
                  }
                },
                "required": [
                  "enabled",
                  "optedIn",
                  "status",
                  "reason",
                  "retryAt"
                ]
              },
              "weekly_notice": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "enabled": {
                    "type": "boolean"
                  },
                  "optedIn": {
                    "type": "boolean"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "allowed",
                      "deferred",
                      "unknown",
                      "refused",
                      "disabled"
                    ]
                  },
                  "reason": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$",
                    "nullable": true
                  },
                  "retryAt": {
                    "type": "string",
                    "format": "date-time",
                    "nullable": true
                  }
                },
                "required": [
                  "enabled",
                  "optedIn",
                  "status",
                  "reason",
                  "retryAt"
                ]
              },
              "weekly_email": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "enabled": {
                    "type": "boolean"
                  },
                  "optedIn": {
                    "type": "boolean"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "allowed",
                      "deferred",
                      "unknown",
                      "refused",
                      "disabled"
                    ]
                  },
                  "reason": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$",
                    "nullable": true
                  },
                  "retryAt": {
                    "type": "string",
                    "format": "date-time",
                    "nullable": true
                  }
                },
                "required": [
                  "enabled",
                  "optedIn",
                  "status",
                  "reason",
                  "retryAt"
                ]
              }
            },
            "required": [
              "alert",
              "weekly_notice",
              "weekly_email"
            ]
          },
          "counts": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "queued": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740989
              },
              "held": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740989
              },
              "sending": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740989
              },
              "awaiting_email": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740989
              },
              "accepted": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740989
              },
              "refused": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740989
              },
              "uncertain": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740989
              }
            },
            "required": [
              "queued",
              "held",
              "sending",
              "awaiting_email",
              "accepted",
              "refused",
              "uncertain"
            ]
          },
          "coverage": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "partial"
                ]
              },
              "limits": {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                }
              }
            },
            "required": [
              "status",
              "limits"
            ]
          }
        },
        "required": [
          "families",
          "counts",
          "coverage"
        ]
      },
      "InsightAlertsListResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAlertsList"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAlertsList": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "alertId": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                },
                "createdAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "deliveryStatus": {
                  "type": "string",
                  "enum": [
                    "queued",
                    "held",
                    "sending",
                    "awaiting_email",
                    "accepted",
                    "refused",
                    "uncertain"
                  ]
                },
                "subjectCount": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 10,
                  "nullable": true
                },
                "admission": {
                  "type": "string",
                  "enum": [
                    "ready",
                    "unavailable"
                  ]
                }
              },
              "required": [
                "alertId",
                "createdAt",
                "deliveryStatus",
                "subjectCount",
                "admission"
              ]
            },
            "maxItems": 20
          },
          "hasMore": {
            "type": "boolean"
          },
          "nextCursor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1500,
            "nullable": true
          }
        },
        "required": [
          "items",
          "hasMore",
          "nextCursor"
        ]
      },
      "InsightAlertsError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "InsightAlertResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAlert"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAlert": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "alertId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "status": {
            "type": "string",
            "enum": [
              "ready",
              "unavailable"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "deliveryStatus": {
            "type": "string",
            "enum": [
              "queued",
              "held",
              "sending",
              "awaiting_email",
              "accepted",
              "refused",
              "uncertain"
            ]
          },
          "subjects": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "topic": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 250
                    },
                    "family": {
                      "type": "string",
                      "enum": [
                        "documented_attention",
                        "event_opportunity",
                        "priority_review",
                        "recorded_relationship",
                        "recorded_resources",
                        "calendar_preparation",
                        "relationship_continuity",
                        "activity_history"
                      ]
                    },
                    "title": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "conclusion": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "reason": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "proposal": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "text": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1200
                        },
                        "kind": {
                          "type": "string",
                          "enum": [
                            "human_review"
                          ]
                        },
                        "targetId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "text",
                        "kind",
                        "targetId"
                      ]
                    },
                    "evidenceIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "maxItems": 100,
                      "uniqueItems": true
                    },
                    "priorityIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "maxItems": 100,
                      "uniqueItems": true
                    },
                    "caveats": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    },
                    "reviewAction": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "type": {
                          "type": "string",
                          "enum": [
                            "review_documented_need",
                            "review_event_fit",
                            "reassess_priority",
                            "review_recorded_exchange",
                            "review_recorded_resources",
                            "review_calendar_preparation",
                            "review_relationship_continuity",
                            "review_activity_history"
                          ]
                        },
                        "targetId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "id",
                        "type",
                        "targetId"
                      ]
                    },
                    "reappearance": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "text": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 800
                        },
                        "evidenceIds": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "maxItems": 100,
                          "uniqueItems": true
                        }
                      },
                      "required": [
                        "text",
                        "evidenceIds"
                      ],
                      "nullable": true
                    }
                  },
                  "required": [
                    "id",
                    "family",
                    "title",
                    "conclusion",
                    "reason",
                    "proposal",
                    "evidenceIds",
                    "priorityIds",
                    "caveats",
                    "reviewAction",
                    "reappearance"
                  ]
                },
                "mode": {
                  "type": "string",
                  "enum": [
                    "ordinary",
                    "deferred_new_deadline"
                  ]
                },
                "deadline": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "event_start"
                      ]
                    },
                    "sourceRef": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "collection": {
                          "type": "string",
                          "enum": [
                            "pe"
                          ]
                        },
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "collection",
                        "id"
                      ]
                    },
                    "deadlineAt": {
                      "type": "string",
                      "format": "date-time"
                    }
                  },
                  "required": [
                    "kind",
                    "sourceRef",
                    "deadlineAt"
                  ]
                },
                "whyNow": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "code": {
                      "type": "string",
                      "enum": [
                        "event_before_next_weekly",
                        "same_event_deadline_advanced_before_defer"
                      ]
                    },
                    "deadlineAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "nextWeeklyAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "evidenceIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "maxItems": 20,
                      "uniqueItems": true
                    },
                    "costOfWaitingCode": {
                      "type": "string",
                      "enum": [
                        "event_starts_before_theoretical_report",
                        "event_now_precedes_defer_and_weekly"
                      ]
                    }
                  },
                  "required": [
                    "code",
                    "deadlineAt",
                    "nextWeeklyAt",
                    "evidenceIds",
                    "costOfWaitingCode"
                  ]
                },
                "deadlineChange": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "previousAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "currentAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "sourceRef": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "collection": {
                          "type": "string",
                          "enum": [
                            "pe"
                          ]
                        },
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "collection",
                        "id"
                      ]
                    },
                    "evidenceIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "maxItems": 20,
                      "uniqueItems": true
                    }
                  },
                  "required": [
                    "previousAt",
                    "currentAt",
                    "sourceRef",
                    "evidenceIds"
                  ],
                  "nullable": true
                },
                "reportMaintained": {
                  "type": "boolean"
                },
                "deferredUntil": {
                  "type": "string",
                  "format": "date-time",
                  "nullable": true
                },
                "evidence": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "nature": {
                        "type": "string",
                        "enum": [
                          "declared",
                          "recorded_fact",
                          "prepared_suggestion"
                        ]
                      },
                      "source": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "collection": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "id": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          }
                        },
                        "required": [
                          "collection",
                          "id"
                        ],
                        "nullable": true
                      },
                      "contactId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "nullable": true
                      },
                      "observedAt": {
                        "type": "string",
                        "format": "date-time"
                      },
                      "occurredAt": {
                        "type": "string",
                        "format": "date-time",
                        "nullable": true
                      },
                      "occurredOn": {
                        "type": "string",
                        "format": "date",
                        "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                        "nullable": true
                      },
                      "datePrecision": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "labelCode": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "text": {
                        "type": "string",
                        "minLength": 0,
                        "maxLength": 16000
                      },
                      "facts": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "code": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "pattern": "^[A-Za-z0-9_:.\\-]+$",
                              "description": "Fait typé admis. contact_marked_local est true/false/null pour le marquage local actuel, pas une localisation physique. registration_count compte les contacts inscrits admis, pas des familles ni des présences. La couverture ne mesure pas l’avancement des préparatifs. Faits des sources étendues DEV : recorded_interaction est une trace CRM datée, pas un besoin non satisfait prouvé. recorded_resources sépare les devises et deux périodes UTC complètes de 30 jours excluant la journée courante ; l’unité monétaire minor:CODE:EXP signifie diviser par 10^EXP. Des totaux null indiquent des données non qualifiées ou exclues, jamais zéro. Ce sont des paiements bruts enregistrés, pas une trésorerie disponible, uniquement des dons, un règlement bancaire ou un budget de projet. community_calendar est une échéance civile calculée, pas une disponibilité personnelle ni un préparatif manquant. Les vues DEV relationship_history et activity_history exigent conjointement contacts, events et registrations. firstVisibleRegistrationAt désigne la première inscription validée visible dans la fenêtre de 180 jours, pas le début réel de la relation. laterRecordedInteractionCount compte les traces instantanées strictement ultérieures ; une précision au jour ne prouve pas l’ordre. Les activités sont réparties par début enregistré de l’événement, pas par création d’inscription, sur deux périodes UTC complètes de 90 jours. Contacts distincts, couples contact–événement et moyennes par événement sont des unités différentes. comparisonAvailable=false interdit une comparaison de tendance. Les identifiants sources synthétiques insight_relationship_history et insight_activity_history sont des projections opaques, pas des identifiants d’événement. Un même groupe explicite ne prouve pas des formats/publics identiques, une présence, fidélité ou efficacité causale. Les inscriptions valides archivées sont incluses dans leur état actuel ; aucune photographie historique immuable n’est implicite. Les bornes from/splitAt/to sont des bornes UTC semi-ouvertes ; la fin est exclue. La continuité sans inscription est aussi admise : firstVisibleInteractionAt/lastVisibleInteractionAt et laterRecordedExchangeCount se réfèrent au premier échange instantané visible. laterRecordedInteractionCount reste relatif à la première inscription visible et vaut null sans celle-ci. firstEverContactAt/firstEverRegistrationAt restent inconnus. registrationChronologyKnown=false masque les mesures d’inscription sans inventer zéro ni supprimer les échanges datés qualifiés."
                            },
                            "value": {
                              "oneOf": [
                                {
                                  "type": "string",
                                  "maxLength": 16000
                                },
                                {
                                  "type": "number"
                                },
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "string",
                                  "nullable": true,
                                  "enum": [
                                    null
                                  ]
                                }
                              ]
                            },
                            "unit": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100,
                              "nullable": true
                            }
                          },
                          "required": [
                            "code",
                            "value",
                            "unit"
                          ]
                        },
                        "maxItems": 50
                      },
                      "references": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "collection": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200
                            },
                            "contactId": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "nullable": true
                            },
                            "quote": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 10000,
                              "nullable": true
                            },
                            "at": {
                              "type": "string",
                              "format": "date-time",
                              "nullable": true
                            },
                            "occurredOn": {
                              "type": "string",
                              "format": "date",
                              "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                              "nullable": true
                            },
                            "datePrecision": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "pattern": "^[A-Za-z0-9_:.\\-]+$"
                            }
                          },
                          "required": [
                            "collection",
                            "id",
                            "contactId",
                            "quote",
                            "at",
                            "occurredOn",
                            "datePrecision"
                          ]
                        },
                        "maxItems": 8
                      },
                      "limits": {
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200,
                          "pattern": "^[A-Za-z0-9_:.\\-]+$"
                        },
                        "maxItems": 100
                      }
                    },
                    "required": [
                      "id",
                      "nature",
                      "source",
                      "contactId",
                      "observedAt",
                      "occurredAt",
                      "occurredOn",
                      "datePrecision",
                      "labelCode",
                      "text",
                      "facts",
                      "references",
                      "limits"
                    ]
                  },
                  "maxItems": 20
                }
              },
              "required": [
                "topic",
                "mode",
                "deadline",
                "whyNow",
                "deadlineChange",
                "reportMaintained",
                "deferredUntil",
                "evidence"
              ]
            },
            "maxItems": 10
          },
          "coverage": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "partial"
                ]
              },
              "limits": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "maxItems": 100
              }
            },
            "required": [
              "status",
              "limits"
            ]
          },
          "privacy": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "classification": {
                "type": "string",
                "enum": [
                  "personal"
                ]
              }
            },
            "required": [
              "classification"
            ]
          }
        },
        "required": [
          "alertId",
          "status",
          "createdAt",
          "deliveryStatus",
          "subjects",
          "coverage",
          "privacy"
        ]
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
